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Preface 


Intended Audience 


The HP OpenVMS System Analysis Tools Manual is intended primarily for the 
system programmer or analyst who must investigate the causes of system failures 
and debug kernel-mode code, such as a device driver. 


This manual also includes system management information for maintaining the 
system resources necessary to capture and store system crash dumps, including 
the use of dump-off-system-disk (DOSD). To help determine the cause of a hung 
process or improve system performance, consult this manual for instructions on 
using the appropriate system analysis tool to analyze your system. 


Document Structure 


This HP OpenVMS System Analysis Tools Manual contains an introductory 
chapter and four parts. 


Chapter 1 presents an overview of the system analysis tools, which are: 


e System Dump Analyzer Utility including Crash Log Utility Extractor, On- 
Chip Logic Analyzer Utility, Spinlock Tracing Utility, Extended File Cache 
extensions, and Callable Routines extensions 


e System Code and Alpha System Dump debuggers 
e Alpha Watchpoint Utility 

e System Service Logging Utility 

e Delta/XDelta Debugger 

e Dump-Off-System-Disk 


Part I describes the System Dump Analyzer (SDA), its use and commands, the 

SDA Crash Log Utility Extractor (CLUE), the On-Chip Logic Analyzer (OCLA), 
and several SDA extensions: Spinlock Tracing (SPL), SDA Extended File Cache 
(XFC), and SDA callable routines. 


Part II describes the System Code Debugger (SCD) and the Alpha System Dump 
Debugger (SDD). 


Part III describes the Alpha Watchpoint Utility (WP). 
Part IV describes the System Service Logging Utility (SSLOG). 
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e HP OpenVMS Calling Standard 

e HP OpenVMS System Manager’s Manual, Volume 1: Essentials 


e HP OpenVMS System Manager’s Manual, Volume 2: Tuning, Monitoring, and 
Complex Systems 
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e Writing OpenVMS Alpha Device Drivers in C 
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For additional information about HP OpenVMS products and services, visit the 
following World Wide Web address: 


http: //www.hp.com/products/openvms 


Reader’s Comments 


HP welcomes your comments on this manual. Please send comments to either of 
the following addresses: 


Internet openvmsdoc@hp.com 


Postal Mail Hewlett-Packard Company 
OSSG Documentation Group, ZKO3-4/U08 
110 Spit Brook Rd. 
Nashua, NH 03062-2698 


How To Order Additional Documentation 


For information about how to order additional documentation, visit the following 
World Wide Web address: 


http: //www.hp.com/go/openvms/doc/order 


Conventions 


XiV 


In this manual, any reference to OpenVMS is synonymous with HP OpenVMS. 


VMScluster systems are referred to as OpenVMS Cluster systems. Unless 
otherwise specified, references to OpenVMS Clusters or clusters in this document 
are synonymous with VMSclusters. 


The following conventions are used in this manual: 


Ctrl/x A sequence such as Ctrl/x indicates that you must hold down 
the key labeled Ctrl while you press another key or a pointing 
device button. 


PF1 x 


Return 


() 


{} 


bold type 


italic type 


UPPERCASE TYPE 


Example 


A sequence such as PF 1 x indicates that you must first press 
and release the key labeled PF1 and then press and release 
another key or a pointing device button. 


In examples, a key name enclosed in a box indicates that 
you press a key on the keyboard. (In text, a key name is not 
enclosed in a box.) 


In the HTML version of this document, this convention appears 
as brackets, rather than a box. 


A horizontal ellipsis in examples indicates one of the following 
possibilities: 


e Additional optional arguments in a statement have been 
omitted. 


e The preceding item or items can be repeated one or more 
times. 


e Additional parameters, values, or other information can be 
entered. 


A vertical ellipsis indicates the omission of items from a code 
example or command format; the items are omitted because 
they are not important to the topic being discussed. 


In command format descriptions, parentheses indicate that you 
must enclose choices in parentheses if you specify more than 
one. 


In command format descriptions, brackets indicate optional 
choices. You can choose one or more items or no items. 

Do not type the brackets on the command line. However, 
you must include the brackets in the syntax for OpenVMS 
directory specifications and for a substring specification in an 
assignment statement. 


In command format descriptions, vertical bars separate choices 
within brackets or braces. Within brackets, the choices are 
optional; within braces, at least one choice is required. Do not 
type the vertical bars on the command line. 


In command format descriptions, braces indicate required 
choices; you must choose at least one of the items listed. Do 
not type the braces on the command line. 


Bold type represents the introduction of a new term. It also 
represents the name of an argument, an attribute, or a reason. 


Italic type indicates important information, complete titles 
of manuals, or variables. Variables include information that 
varies in system output (Internal error number), in command 
lines (PRODUCER=name), and in command parameters in 
text (where dd represents the predefined code for the device 
type). 


Uppercase type indicates a command, the name of a routine, 
the name of a file, or the abbreviation for a system privilege. 


This typeface indicates code examples, command examples, and 
interactive screen displays. In text, this type also identifies 
URLs, UNIX commands and pathnames, PC-based commands 
and folders, and certain elements of the C programming 
language. 


A hyphen at the end of a command format description, 
command line, or code line indicates that the command or 
statement continues on the following line. 


XV 


numbers All numbers in text are assumed to be decimal unless 
otherwise noted. Nondecimal radixes—binary, octal, or 
hexadecimal—are explicitly indicated. 


Hat followed by a letter represents an SDA operator. For 
additional information, see Table 2-3, SDA Operators. 
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Overview of System Analysis Tools 


This chapter presents an overview of the following system dump analysis tools 


and features: 


e System Dump Analyzer (SDA) 
e System Code Debugger (SCD) 


e Alpha System Dump Debugger (SDD) 


e Alpha Watchpoint Utility (WP) 


e Alpha Delta Debugger 
e XDelta Debugger 


e Dump-Off-System-Disk (DOSD) 
e System Service Logging Utility (SSLOG) 
e On-Chip Logic Analyzer (OCLA) 


To do the following: Use this utility: Described in: 

Analyze a running system. SDA Chapter 2, SDA 
Description 

Analyze a dump file. SDA Chapter 2, SDA 
Description 

Automate the analysis of crash CLUE Chapter 5, SDA CLUE 

dumps and maintain a fatal- Extension 

bugcheck history. 

Debug nonpagable system code and SCD Chapter 11, OpenVMS 

device drivers running at any IPL. System Code Debugger 

Analyze certain system dumps, SDD Chapter 12, OpenVMS 

display source code, variables or Alpha System Dump 

registers in use at the time of a Debugger 

system failure. 

Maintain a history of modifications WP Chapter 13, The Alpha 


made to a specific location in shared 
memory on an Alpha system. 


Monitor execution of user programs 
and OpenVMS Alpha running at 
IPLO. 


Debug system code that runs early 
in booting or when there is no 
Ethernet adapter dedicated to SCD. 


Write the system dump file to a 
device other than the system disk. 


Delta Debugger 


Xdelta Debugger 


DOSD 


Watchpoint Utility 


Section 1.6, Delta/XDelta 
Debugger 


Section 1.6, Delta/XDelta 
Debugger 


Section 1.7, Dump-Off- 
System-Disk (DOSD) 
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To do the following: Use this utility: Described in: 

Characterize spinlock usage SPL Chapter 8, SDA Spinlock 

and collect per-CPU spinlock Tracing Utility (SPL) 

performance data. 

Display XFC data structures and XFC Chapter 9, SDA 

statistics to help tune the extended Extended File Cache 

file cache. Extension (XFC) 

Extend the functionality of SDA. SDA Extension Chapter 10, SDA 

Callable Routines Callable Routines 

Extension 

Log system services. SSLOG Chapter 14, System 
Service Logging 

Determine which instructions have OCLA Chapter 6, SDA Alpha 

executed in a specific Alpha EV7 OCLA 

CPU. 


1.1 System Dump Analyzer (SDA) 


The OpenVMS system dump analyzer (SDA) utility enables you to analyze a 
running system or a system dump after a system failure occurs. With a system 
failure, the operating system copies the contents of memory to a system dump 
file or the primary page file. Additionally, it records the hardware context of each 
processor. With SDA, you can interpret the contents of the dump file, examine 
the status of each processor at the time of the system failure, and investigate 
possible causes of failure. 


See Part I for more complete information about SDA, SDA CLUE (Crash Log 
Utility Extractor), SPL (Spinlock Tracing Utility), other SDA extensions, and the 
SDA Extension routines. 


1.2 System Code Debugger (SCD) 


The OpenVMS System Code Debugger (SCD) allows you to debug nonpageable 
system code and device drivers running at any interupt priority level (IPL). You 
can use the SCD to perform the following tasks: 


e Control the system software’s execution—-stop at points of interest, resume 
execution, intercept fatal exceptions, and so on 


e Trace the execution path of the system software 


e Display the source code where the software is executing, and step by source 
line 


e Monitor exception conditions 
e Examine and modify the values of variables 


e In some cases, test the effect of modifications without having to edit the 
source code, recompile, and relink 


SCD is a symbolic debugger. You can specify variable names, routine names, and 
so on, precisely as they appear in your source code. 


SCD recognizes the syntax, data typing, operators, expressions, scoping rules, 
and other constructs of a given language. If your code or driver is written in more 
than one language, you can change the debugging context from one language to 
another during a debugging session. 
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See Part II for complete information about SCD. 


1.3 Alpha System Dump Debugger (SDD) 


The OpenVMS Alpha System Dump Debugger allows you to analyze certain 
system dumps using the commands and semantics of SCD. You can use SDD to 
perform the following tasks: 


e Display the source code where the software was executing at the time of the 
system failure 


e Examine the values of variables and registers at the time of the system 
failure 


SDD is a symbolic debugger. You can specify variable names, routine names, and 
so on, precisely as they appear in your source code. 


SDD recognizes the syntax, data typing, operators, expressions, scoping rules, 
and other constructs of a given language. If your code or driver is written in more 
than one language, you can change the debugging context from one language to 
another during a debugging session. 


See Part II for complete information about SDD. 


1.4 Alpha Watchpoint Utility 


The OpenVMS Watchpoint utility allows you to maintain a history of 
modifications that are made to a particular location in shared system space. 
It sets watchpoints on 32-bit and 64-bit addresses, and watches any system 
addresses whether in SO, S1, or S2 space. 


See Part III for complete information about the Watchpoint utility. 


1.5 System Service Logging 


To log system services, use the System Service Logging (SSLOG) Utility. For 
additional information, see Chapter 14, System Service Logging. 


1.6 Delta/XDelta Debugger 


The OpenVMS Delta/XDelta debugger allows you to monitor the execution of 
user programs and the OpenVMS operating system. The Delta/XDelta debuggers 
both use the same commands and expressions, but they are different in how they 
operate. Delta operates as an exception handler in a process context; whereas 
XDelta is invoked directly from the hardware system control block (SCB) vector 
in a system context. 


Note 
OpenVMS Delta runs only on OpenVMS Alpha systems. 


You use OpenVMS Alpha Delta instead of the OpenVMS symbolic debugger to 
debug programs that run in privileged processor mode at interrupt priority level 
(IPL) 0. Because Delta operates in a process context, you can use it to debug 
user-mode programs or programs that execute at interrupt priority level (IPL) 0 
in any processor mode—user, supervisor, executive, and kernel. To run Delta in a 
processor mode other than user mode, your process must have the privilege that 
allows Delta to change to that mode: change-mode-to-executive (CMEXEC), or 
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change-mode-to-kernel (CMKRNL) privilege. You cannot use Delta to debug code 
that executes at an elevated IPL. To debug with Delta, you invoke it from within 
your process by specifying it as the debugger instead of the symbolic debugger. 


You use OpenVMS XDelta instead of the System Code Debugger when debugging 
system code that runs early in booting or when there is no Ethernet adapter 
that can be dedicated to SCD. Because XDelta is invoked directly from the 
hardware system control block (SCB), it can be used to debug programs executing 
in any processor mode or at any IPL level. To use XDelta, you must have system 
privileges, and you must include XDelta when you boot the system. Since XDelta 
is not process specific, it is not invoked from a process. To debug with XDelta, 
you must boot the system with a command to include XDelta in memory. XDelta’s 
existence terminates when you reboot the system without XDelta. 


On OpenVMS systems, XDelta supports 64-bit addressing. Quadword display 
mode displays full quadwords of information. The 64-bit address display mode 
accepts and displays all addresses as 64-bit quantities. XDelta has predefined 
command strings for displaying the contents of the page frame number (PFN) 
database. 


You can use Delta/XDelta commands to perform the following debugging tasks: 
e Open, display, and change the value of a particular location 

e Set, clear, and display breakpoints 

e Set, display modes in byte, word, longword, or ASCII 

e Display instructions 

e Execute the program in a single step with the option to step over a subroutine 
e Set base registers 

e List the names and locations of all loaded modules of the executive 

e Map an address to an executive module 

See the HP OpenVMS Delta/XDelta Debugger Manual for complete information 
about using the Delta/XDelta debugging utility. 


1.7 Dump-Off-System-Disk (DOSD) 


The OpenVMS system allows you to write the system dump file to a device other 
than the system disk. This is useful in large memory systems and in clusters 
with common system disks where sufficient disk space, on one disk, is not always 
available to support your dump file requirements. To perform this activity, you 
must correctly enable the DUMPSTYLE system parameter to allow the bugcheck 
code to write the system dump file to an alternative device. 


See the HP OpenVMS System Manager’s Manual, Volume 2: Tuning, Monitoring, 
and Complex Systems for complete information about how to write the system 
dump file to a disk other than the system disk. 


1.8 On-Chip Logic Analyzer (OCLA) 


The Alpha EV7 On-chip Logic Analyzer utility (OCLA) enables a user to 
determine which instructions have executed on an Alpha EV7 CPU. One-seventh 
of the Alpha EV7 cache is set aside as acquisition memory where the virtual 
addresses of instructions executed by the Alpha EV7 CPU are stored. The 
acquisition memory can later by analyzed with SDA. For more information on 
OCLA, see Chapter 6, SDA Alpha OCLA . 
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Part | 


OpenVMS System Dump Analyzer (SDA) 


Part I describes the capabilities and system management of SDA. It describes 
how to use SDA to perform the following tasks: 


Analyzing a system dump and a running system 
Understanding SDA context and commands 
Investigating system failures 

Inducing system failures 

Understanding the ANALYZE command and qualifiers 


Invoking SDA commands, SDA CLUE extension commands, SDA Spinlock 
Tracing commands, and SDA extension routines 


Determining which instructions have executed in a specific Alpha system 
CPU, with SDA OCLA commands 
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SDA Description 


This chapter describes the functions and the system management of SDA. It 
describes initialization, operation, and procedures in analyzing a system dump 
and analyzing a running system. This chapter also describes the SDA context, 
the command format, and the way both to investigate system failures and induce 
system failures. 


2.1 Capabilities of SDA 


When a system failure occurs, the operating system copies the contents of 
memory to a system dump file or the primary page file, recording the hardware 
context of each processor in the system as well. The System Dump Analyzer 
(SDA) is a utility that allows you to interpret the contents of this file, examine 
the status of each processor at the time of the system failure, and investigate the 
probable causes of the failure. 


You can invoke SDA to analyze a system dump, using the DCL command 
ANALYZE/CRASH_DUMP. You can then use SDA commands to perform the 
following operations: 


e Direct (or echo) the output of an SDA session to a file or device (SET OUTPUT 
or SET LOG). 


e Display the condition of the operating system and the hardware context of 
each processor in the system at the time of the system failure (SHOW CRASH 
or CLUE CRASH). 


e Select a specific processor in a multiprocessing system as the subject of 
analysis (SET CPU). 


e Select the default size of address data manipulated by the EXAMINE and 
EVALUATE commands (SET FETCH). 


e Enable or disable the sign extension of 32-bit addresses (SET SIGN_ 
EXTEND). 


e Display the contents of a specific process stack (SHOW STACK or CLUE 
STACK). 


e Format a call frame from a stack location (SHOW CALL_FRAME). 
e Read a set of global symbols into the SDA symbol table (READ). 


e Define symbols to represent values or locations in memory and add them to 
the SDA symbol table (DEFINE). 


e Delete symbols not required from the SDA symbol table (UNDEFINE). 


e Evaluate an expression in hexadecimal and decimal, interpreting its value as 
a symbol, a condition value, a page table entry (PTE), a processor status (PS) 
quadword, or date and time (EVALUATE). 
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Examine the contents of memory locations, optionally interpreting them as 
assembler instructions, a PTE, a PS, or date and time (EXAMINE). 


Display device status as reflected in system data structures (SHOW DEVICE). 


Display the contents of the stored machine check frame (SHOW MACHINE_ 
CHECK or CLUE MCHK) for selected HP computers. 


Format system data structures (FORMAT). 
Validate the integrity of the links in a queue (VALIDATE QUEUE). 
Display a summary of all processes on the system (SHOW SUMMARY). 


Show the hardware or software context of a process (SHOW PROCESS or 
CLUE PROCESS). 


Display the OpenVMS RMS data structures of a process (SHOW PROCESS 
with the /RMS qualifier). 


Display memory management data structures (SHOW POOL, SHOW PFN_ 
DATA, SHOW PAGE_TABLE, or CLUE MEMORY). 


Display lock management data structures (SHOW RESOURCES or SHOW 
LOCKS). 


Display OpenVMS Cluster management data structures (SHOW CLUSTER, 
SHOW CONNECTIONS, SHOW RSPID, or SHOW PORTS). 


Display multiprocessor synchronization information (SHOW SPINLOCKS). 
Display the layout of the executive images (SHOW EXECUTIVE). 


Capture and archive a summary of dump file information in a list file (CLUE 
HISTORY). 


Copy the system dump file (COPY). 
Define keys to invoke SDA commands (DEFINE/KEY). 
Search memory for a given value (SEARCH). 


Although SDA provides a great deal of information, it does not automatically 
analyze all the control blocks and data contained in memory. For this reason, 
in the event of system failure, it is extremely important that you save not only 
the output provided by SDA commands, but also a copy of the system dump file 
written at the time of the failure. 


You can also invoke SDA to analyze a running system, using the DCL command 
ANALYZE/SYSTEM. Most SDA commands generate useful output when entered 
on a running system. 


Caution: 


Although analyzing a running system may be instructive, you should 
undertake such an operation with caution. System context, process 
context, and a processor’s hardware context can change during any given 
display. 

In a multiprocessing environment, it is very possible that, during 
analysis, a process running SDA could be rescheduled to a different 
processor frequently. Therefore, avoid examining the hardware context of 
processors in a running system. 
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2.2 System Management and SDA 


The system manager must ensure that the system writes a dump file whenever 
the system fails. The manager must also see that the dump file is large enough 
to contain all the information to be saved, and that the dump file is saved for 
analysis. The following sections describe these tasks. 


2.2.1 Writing System Dumps 


The operating system attempts to write information into the system dump file 
only if the system parameter DUMPBUG is set. (The DUMPBUG parameter 

is set by default. To examine and change its value, consult the HP OpenVMS 
System Manager’s Manual, Volume 2: Tuning, Monitoring, and Complex Systems.) 
If DUMPBUG is set and the operating system fails, the system manager has the 
following choices for writing system dumps: 


e Have the system dump file written to either SYSDUMP.DMP (the system 
dump file) or to PAGEFILE.SYS (the primary system page file). 


e Set the DUMPSTYLE system parameter to an even number (for dumps 
containing all physical memory) or to an odd number (for dumps containing 
only selected virtual addresses). See Section 2.2.1.1 for more information 
about the DUMPSTYLE parameter values. 


2.2.1.1. Dump File Style 


There are two types of dump files—a full memory dump (also known as a physical 
dump), and a dump of selected virtual addresses (also known as a selective 
dump). Both full and selective dumps may be produced in either compressed or 
uncompressed form. Compressed dumps save disk space and time taken to write 
the dump at the expense of a slight increase in time to access the dump with 
SDA. The SDA commands COPY/COMPRESS and COPY/DECOMPRESS can be 
used to convert an existing dump. 


A dump can be written to the system disk, or to another disk set aside for dumps. 
When using a disk other than a system disk, the disk name is set in the console 
environment variable DUMP_DEV. This disk is also known as the “dump off 
system disk” (DOSD) disk. 


When writing a system dump, information about the crash is displayed at the 
system console. This can be either minimal output (for example, bug check code, 
process name, and image name), or verbose output (for example, executive layout, 
stack and register contents). 


In an OpenVMS Galaxy system, shared memory is dumped by default. It is 
sometimes necessary to disable the dumping of shared memory. For more 
information about shared memory, see HP OpenVMS Alpha Partitioning and 
Galaxy Guide. 


DUMPSTYLE, which specifies the method of writing system dumps, is a 32- 
bit mask. Table 2-1 shows how the bits are defined. Each bit can be set 
independently. The value of the SYSGEN parameter is the sum of the values 
of the bits that have been set. Remaining or undefined values are reserved to 
HP. 
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Table 2-1 Definitions of Bits in DUMPSTYLE 


Bit Value Description 


0 1 0= Full dump. The entire contents of physical memory will be written 
to the dump file. 


1= Selective dump. The contents of memory will be written to the 
dump file selectively to maximize the usefulness of the dump file while 
conserving disk space. (Only pages that are in use are written). 


1 2 0= Minimal console output. This consists of the bugcheck code; the 
identity of the CPU, process, and image where the crash occurred; the 
system date and time; plus a series of dots indicating progress writing 
the dump. 


1= Full console output. This includes the minimal output previously 
described plus stack and register contents, system layout, and 
additional progress information such as the names of processes as 
they are dumped. 


2 4 0= Dump to system disk. The dump will be written to 
SYS$SYSDEVICE:[SYSn.SYSEXE]SYSDUMP.DMP, or in its absence, 
SYS$SYSDEVICE:[SYSn.SYSEXE]PAGEFILE.SYS. 


1= Dump to alternate disk. The dump will be written to 
dump_dev:[SYSn.SYSEXE]SYSDUMP.DMP, where dump_dev is the 
value of the console environment variable DUMP_DEV. 


3 8 0= Uncompressed dump. Pages are written directly to the dump file. 
1= Compressed dump. Each page is compressed before it is written, 


providing a saving in space and in the time taken to write the dump, at 
the expense of a slight increase in time taken to access the dump. 


4 16 0= Dump shared memory. 


1= Do not dump shared memory. 
5-31 Reserved to HP. 


The default setting for DUMPSTYLE is 9 (a compressed selective dump, including 
shared memory, written to the system disk). Unless a value for DUMPSTYLE is 
specified in MODPARAMS.DAT, AUTOGEN.COM will set DUMPSTYLE either 
to 1 (an uncompressed selective dump, including shared memory, written to the 
system disk) if there is less than 128 megabytes of memory on the system, or to 
9 (a compressed selective dump, including shared memory, written to the system 
disk). 


2.2.1.2 Comparison of Full and Selective Dumps 


A full dump requires that all physical memory be written to the dump file. 
This ensures the presence of all the page table pages required for SDA to 
emulate translation of system virtual addresses. Any even-numbered value in 
the DUMPSTYLE system parameter generates a full dump. 


In certain system configurations, it may be impossible to preserve the entire 
contents of memory in a disk file. For instance, a large memory system or a 
system with small disk capacity may not be able to supply enough disk space for 
a full memory dump. If the system dump file cannot accommodate all of memory, 
information essential to determining the cause of the system failure may be lost. 
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To preserve those portions of memory that contain information most useful in 
determining the causes of system failures, a system manager sets the value of 
the DUMPSTYLE system parameter to specify a dump of selected virtual address 
spaces. In a selective dump, related pages of virtual address space are written 
to the dump file as units called logical memory blocks (LMBs). For example, 

one LMB consists of the page tables for system space; another is the address 
space of a particular process. Those LMBs most likely to be useful in crash dump 
analysis are written first. Any odd-numbered value in the DUMPSTYLE system 
parameter generates a selective dump. 


Table 2—2 compares full and selective style dumps. 


Table 2-2 Comparison of Full and Selective Dumps 


Item Full Selective 

Available Complete contents of physical System page table, global page table, system 

Information memory in use, stored in order space memory, and process and control regions 
of increasing physical address. (plus global pages) for all saved processes. 

Unavailable Contents of paged-out memory Contents of paged-out memory at the time of the 

Information at the time of the system failure. system failure, process and control regions of 


SDA Command 
Limitations 


unsaved processes, and memory not mapped by a 
page table. 


None. The following commands are not 
useful for unsaved processes: SHOW 
PROCESS/CHANNELS, SHOW 
PROCESS/IMAGE, SHOW PROCESS/RMS, 
SHOW STACK, and SHOW SUMMARY/IMAGE. 


2.2.1.3 Contro 


lling the Size of Page Files and Dump Files 


You can adjust the size of the system page file and dump file using AUTOGEN 
(the recommended method) or by using SYSGEN. 


AUTOGEN automatically calculates the appropriate sizes for page and dump 
files. AUTOGEN invokes the System Generation utility (SYSGEN) to create 
or change the files. However, you can control sizes calculated by AUTOGEN 
by defining symbols in the MODPARAMS.DAT file. The file sizes specified in 
MODPARAMS.DAT are copied into the PARAMS.DAT file during AUTOGEN’s 
GETDATA phase. AUTOGEN then makes appropriate adjustments in its 
calculations. 


Although HP recommends using AUTOGEN to create and modify page and dump 
file sizes, you can use SYSGEN to directly create and change the sizes of those 
files. 


The sections that follow discuss how you can calculate the size of a dump file. 


See the HP OpenVMS System Manager’s Manual for detailed information about 
using AUTOGEN and SYSGEN to create and modify page and dump file sizes. 


2.2.1.4 Writing to the System Dump File 


OpenVMS writes the contents of the error-log buffers, processor registers, and 
memory into the system dump file, overwriting its previous contents. If the 
system dump file is too small, OpenVMS cannot copy all memory to the file when 
a system failure occurs. 
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SYS$SYSTEM:SYSDUMP.DMP (SYS$SPECIFIC:[SYSEXE]SYSDUMP.DMP) 
is created during installation. To successfully store a crash dump, 
SYS$SYSTEM:SYSDUMP.DMP must be enlarged to hold all of memory (full 
dump) or all of system space and the key processes (selective dump). 


To calculate the correct size for an uncompressed full dump to 
SYS$SYSTEM:SYSDUMP.DMP, use the following formula: 


size-in-blocks (SYSSSYSTEM: SYSDUMP.DMP) 
= size-in-pages(physical-memory) * blocks-per-page 
+ number-of-error-log-buffers * blocks-per-buffer 
+ 10 


Use the DCL command SHOW MEMORY to determine the total size of physical 
memory on your system. There is a variable number of error log buffers in 
any given system, depending on the setting of the ERRORLOGBUFF_S2 
system parameter. The size of each buffer depends on the setting of the 
ERLBUFFERPAG_S2 parameter. (See the HP OpenVMS System Manager’s 
Manual for additional information about these parameters.) 


2.2.1.5 Writing to a Dump File off the System Disk 


OpenVMS allows you to write the system dump file to a device other than 
the system disk. This is useful in large memory systems and in clusters with 
common system disks where sufficient disk space, on one disk, is not always 
available to support customer dump file requirements. To perform this activity, 
the DUMPSTYLE system parameter must be correctly enabled to allow the 
bugcheck code to write the system dump file to an alternative device. 


The requirements for writing the system dump file off the system disk are the 
following: 


e The dump device directory structure must resemble the current system disk 
structure. The [SYSn.SYSEXE]SYSDUMP.DMP file will reside there, with 
the same boot time system root. 


You can use AUTOGEN to create this file. In the MODPARAMS.DAT file, the 
following symbol prompts AUTOGEN to create the file: 


DUMPFILE DEVICE = $nnn$ddcuuuu 


e The dump device cannot be part of a volume set or a member of a shadow set. 
e You must set up DOSD for SDA CLUE as described in Chapter 5. 


e The DUMP_DEV environment variable must exist on your system. You 
specify the dump device at the console prompt, using the following format: 
For Alpha 
>>> SET DUMP_DEV device-name[,...] 

For I64 
Shell> VMS_SET DUMP DEV device-name[,...] 


On some CPU types, you can enter a list of devices. The list can include 
various alternate paths to the system disk and the dump disk. 


By specifying alternate paths in DUMP_DEYV, a dump can still be written if 
the disk fails over to an alternate path while the system is running. When 
the system crashes, the bugcheck code can use the alternate path by referring 
to the contents of DUMP_DEV. 


When you enter a list of devices, however, the system disk must come last. 
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For information on how to write the system dump file to an alternative device 
to the system disk, see the HP OpenVMS System Manager’s Manual, Volume 2: 
Tuning, Monitoring, and Complex Systems. 


2.2.1.6 Writing to the System Page File 


If SYS$SYSTEM:SYSDUMP.DMP does not exist, and there is no DOSD device 
or dump file, the operating system writes the dump of physical memory into 
SYS$SYSTEM:PAGEFILE.SYS, the primary system page file, overwriting the 
contents of that file. 


If the SAVEDUMP system parameter is set, the dump file is retained in 
PAGEFILE.SYS when the system is booted after a system failure. If the 
SAVEDUMP parameter is not set, which is the default, OpenVMS uses the entire 
page file for paging and any dump written to the page file is lost. (To examine or 
change the value of the SAVEDUMP parameter, consult the HP OpenVMS System 
Manager’s Manual, Volume 2: Tuning, Monitoring, and Complex Systems.) 


To calculate the minimum size for a full memory dump to 
SYS$SYSTEM:PAGEFILE.SYS, use the following formula: 


size-in-blocks (SYSSSYSTEM: PAGEFILE.SYS) 

= size-in-pages(physical-memory) * blocks-per-page 

+ number-of-error-log-buffers * blocks-per-buffer 

+ 10 

+ value of the system parameter RSRVPAGCNT * blocks-per-page 
Note that this formula calculates the minimum size requirement for saving 
a physical dump in the system’s page file. HP recommends that the page 
file be a bit larger than this minimum to avoid hanging the system. Also 
note that you can only write the system dump into the primary page file 
(SYS$SYSTEM:PAGEFILE.SYS). Secondary page files cannot be used to save 
dump file information. 


Note also that OpenVMS will not fill the page file completely when writing a 
system dump, since the system might hang when rebooting after a system crash. 
RSRVPAGCNT pages are kept unavailable for dumps. This applies to both full 
dumps and selective dumps. 


Writing crash dumps to SYS$SYSTEM:PAGEFILE.SYS presumes that you will 
later free the space occupied by the dump for use by the pager. Otherwise, your 
system may hang during the startup procedure. To free this space, you can do 
one of the following: 


e Include SDA commands that free dump space in the site-specific startup 
command procedure (described in Section 2.2.3). 


e Use the SDA COPY command to copy the dump from 
SYS$SYSTEM:PAGEFILE.SYS to another file. Use the SDA COPY command 
instead of the DCL COPY command because the SDA COPY command only 
copies the blocks used by the dump and causes the pages occupied by the 
dump to be freed from the system’s page file. 


e If you do not need to copy the dump elsewhere, issue an ANALYZE/CRASH_ 
DUMP/RELEASE command. When you issue this command, SDA 
immediately releases the pages to be used for system paging, effectively 
deleting the dump. Note that this command does not allow you to analyze the 
dump before deleting it. 
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2.2.2 Saving System Dumps 


Every time the operating system writes information to the system dump file, 
it writes over whatever was previously stored in the file. The system writes 
information to the dump file whenever the system fails. For this reason, the 
system manager must save the contents of the file after a system failure has 
occurred. 


The system manager can use the SDA COPY command or the DCL COPY 
command. Either command can be used in a site-specific startup procedure, but 
the SDA COPY command is preferred because it marks the dump file as copied. 
As mentioned earlier, this is particularly important if the dump was written 
into the page file, SYS$SYSTEM:PAGEFILE.SYS, because it releases those 
pages occupied by the dump to the pager. Another advantage of using the SDA 
COPY command is that this command copies only the saved number of blocks 
and not necessarily the whole allotted dump file. For instance, if the size of the 
SYSDUMP.DMP file is 100,000 blocks and the bugcheck wrote only 60,000 blocks 
to the dump file, then DCL COPY would create a file of 100,000 blocks. However, 
SDA COPY would generate a file of only 60,000 blocks. 


Because system dump files are set to NOBACKUP, the Backup utility (BACKUP) 
does not copy them to tape unless you use the qualifier IGNORE=NOBACKUP 
when invoking BACKUP. When you use the SDA COPY command to copy 

the system dump file to another file, OpenVMS does not set the new file to 
NOBACKUP. 


As created during installation, the file SYS$SYSTEM:SYSDUMP.DMP is 
protected against world access. Because a dump file can contain privileged 
information, HP recommends that the system manager does not change this 
default protection. 


2.2.3 Invoking SDA When Rebooting the System 


When the system reboots after a system failure, SDA is automatically invoked by 
default. SDA archives information from the dump in a history file. In addition, 
a listing file with more detailed information about the system failure is created 
in the directory pointed to by the logical name CLUE$COLLECT. (Note that 

the default directory is SYS$ERRORLOG unless you redefine the logical name 
CLUE$COLLECT in the procedure SYS$MANAGER:SYLOGICALS.COM.) The 
file name is in the form CLUE$node_ddmmyy_hhmm.LIS where the timestamp 
(hhmm) corresponds to the system failure time and not the time when the file 
was created. 


Directed by commands in a site-specific file, SDA can take additional steps to 
record information about the system failure. They include the following: 


e Copying the contents of the dump file to another file. This information is 
otherwise lost at the next system failure when the system saves information 
only about that failure. 


e Supplementing the contents of the list file containing the output of specific 
SDA commands. 


If the logical name CLUE$SITE_PROC points to a valid and existing 
command file, it will be executed as part of the CLUE HISTORY command 
when you reboot. If used, this file should contain only valid SDA commands. 
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Generated by a set sequence of commands, the CLUE list file contains only 
an overview of the failure and is unlikely to provide enough information 
to determine the cause of the failure. HP, therefore, recommends that you 
always copy the dump file. 


The following example shows SDA commands that can make up your site-specific 
command file to produce a more complete SDA listing after each system failure, 
and to save a copy of the dump file: 


SDA command file, to be executed as part of the system 
bootstrap from within CLUE. Commands in this file can 

be used to save the dump file after a system bugcheck, and 
to execute any additional SDA commands. 


! Note that the logical name DMP$ must have been defined 


! within SYSSMANAGER:SYLOGICALS.COM 
! 


READ /EXEC ! read in the executive images’ symbol tables 
SHOW STACK ! display the stack 
COPY DMPS$:SAVEDUMP. DMP ! copy and save dump file 


The CLUE HISTORY command is executed first, followed by the SDA commands 
in this site-specific command file. See the reference section on CLUE HISTORY 
for details on the summary information that is generated and stored in the CLUE 
list file by the CLUE HISTORY command. Note that the SDA COPY command 
must be the last command in the command file. If the dump has been written to 
PAGEFILE.SYS, then the space used by the dump will be automatically returned 
for use for paging as soon as the COPY is complete and no more analysis is 
possible. 


To point to your site-specific file, add a line such as the following to the file 
SYS$MANAGER:SYLOGICALS.COM: 


$ DEFINE/SYSTEM CLUESSITE PROC SYSSMANAGER: SAVEDUMP .COM 
In this example, the site-specific file is named SAVEDUMP.COM. 
The CLUE list file can be printed immediately or saved for later examination. 


SDA is invoked and executes the specified commands only when the system boots 
for the first time after a system failure. If the system is booting for any other 
reason (such as a normal system shutdown and reboot), SDA exits. 


If CLUE files occupy more space than the threshold allows (the default is 5000 
blocks), the oldest files will be deleted until the threshold limit is reached. The 
threshold limit can be customized with the CLUE$MAX_BLOCK logical name. 


To prevent the running of CLUE at system startup, define the logical 
CLUE$INHIBIT in the SYLOGICALS.COM file as TRUE in the system logical 
name table. 


2.3 Analyzing a System Dump 


SDA performs certain tasks before bringing a dump into memory, presenting its 
initial displays, and accepting command input. These tasks include the following: 


e Verifying that the process invoking it is suitably privileged to read the dump 
file 


e Using RMS to read in pages from the dump file 
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e Building the SDA symbol table from the files SDA$SREAD_DIR:SYS$BASE_ 
IMAGE.EXE and SDA$READ_DIR:REQSYSDEF.STB 


e Executing the commands in the SDA initialization file 


For detailed information on investigating system failures, see Section 2.7. 


2.3.1 Requirements 


To analyze a dump file, your process must have read access both to the file that 
contains the dump and to copies of SDA$SREAD_DIR:SYS$BASE_IMAGE.EXE 
and SDA$READ_DIR:REQSYSDEF:STB (the required subset of the symbols in 
the file SYSDEF.STB). SDA reads these tables by default. 


2.3.2 Invoking SDA 
If your process can access the files listed in Section 2.3.1, you can issue the DCL 
command ANALYZE/CRASH_DUMP to invoke SDA. If you do not specify the 
name of a dump file in the command, SDA prompts you: 


$ ANALYZE/CRASH_DUMP 
_Dump File: 


The default file specification is as follows: 
SYS$DISK:[default-dir]JSYSDUMP.DMP 


SYS$DISK and [default-dir] represent the disk and directory specified in your 
last SET DEFAULT command. 


If you are rebooting after a system failure, SDA is automatically invoked. See 
Section 2.2.3. 


2.3.3 Mapping the Contents of the Dump File 


SDA first attempts to map the contents of memory as stored in the specified 
dump file. To do this, it must first locate the page tables for system space among 
its contents. The system page tables contain one entry for each page of system 
virtual address space. 


e If SDA cannot find the system page tables in the dump file, it displays the 
following message: 


%SDA-E-SPTNOTFND, system page table not found in dump file 


If that error message is displayed, you cannot analyze the crash dump, 

but must take steps to ensure that any subsequent dump can be analyzed. 
To do this, you must either adjust the DUMPSTYLE system parameter as 
discussed in Section 2.2.1.1 or increase the size of the dump file as indicated 
in Section 2.2.1.3. 


e If SDA finds the system page tables in an incomplete dump, the following 
message is displayed: 


%SDA-W-SHORTDUMP, dump file was n blocks too small when dump written; 
analysis may not be possible 


Under certain conditions, some memory locations might not be saved in the 
system dump file. Additionally, if a bugcheck occurs during system initialization, 
the contents of the register display may be unreliable. The symptom of such a 
bugcheck is a SHOW SUMMARY display that shows no processes or only the 
swapper process. 
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If you use an SDA command to access a virtual address that has no corresponding 
physical address, SDA generates the following error message: 


%SDA-E-NOTINPHYS, ‘location’: virtual data not in physical memory 


When analyzing a selective dump file, if you use an SDA command to access a 
virtual address that has a corresponding physical address not saved in the dump 
file, SDA generates one of the following error messages: 


%SDA-E-MEMNOTSVD, memory not saved in the dump file 
%SDA-E-NOREAD, unable to access location n 


2.3.4 Building the SDA Symbol Table 


After locating and reading the system dump file, SDA attempts to read the system 
symbol table file into the SDA symbol table. If SDA cannot find SDA$READ_ 
DIR:SYS$BASE_IMAGE.EXE—or is given a file that is not a system symbol 
table in the (SYMBOL qualifier to the ANALYZE command—it displays a fatal 
error and exits. SDA also reads into its symbol table a subset of SDA$¢READ_ 
DIR:SYSDEF.STB, called SDA$READ_DIR:REQSYSDEF:STB. This subset 
provides SDA with the information needed to access some of the data structures 
in the dump. 


When SDA finishes building its symbol table, SDA displays a message identifying 
itself and the immediate cause of the system failure. In the following example, 
the cause of the system failure was the deallocation of a bad page file address. 


OpenVMS Alpha System Dump Analyzer 


Dump taken on 27-MAR-1993 11:22:33.92 
BADPAGFILD, Bad page file address deallocated 


2.3.5 Executing the SDA Initialization File (SDAS$INIT) 


After displaying the system failure summary, SDA executes the commands in the 
SDA initialization file, if you have established one. SDA refers to its initialization 
file by using the logical name SDA$INIT. If SDA cannot find the file defined as 
SDAS$INIT, it searches for the file SYS$LOGIN:SDA.INIT. 


This initialization file can contain SDA commands that read symbols into SDA’s 
symbol table, define keys, establish a log of SDA commands and output, or 
perform other tasks. For instance, you may want to use an SDA initialization file 
to augment SDA’s symbol table with definitions helpful in locating system code. If 
you issue the following command, SDA includes those symbols that define many 
of the system’s data structures, including those in the I/O database: 


READ SDASREAD DIR: filename 


You may also find it helpful to define those symbols that identify the modules in 
the images that make up the executive by issuing the following command: 


READ/EXECUTIVE SDASREAD DIR: 


After SDA has executed the commands in the initialization file, it displays its 
prompt as follows: 


SDA> 


This prompt indicates that you can use SDA interactively and enter SDA 
commands. 


An SDA initialization file may invoke a command procedure with the @ command. 
However, such command procedures cannot invoke other command procedures. 
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2.4 Analyzing a Running System 


Occasionally, OpenVMS encounters an internal problem that hinders system 
performance without causing a system failure. By allowing you to examine the 
running system, SDA enables you to search for the solution without disturbing 
the operating system. For example, you may be able to use SDA to examine the 
stack and memory of a process that is stalled in a scheduler state, such as a 
miscellaneous wait (MWAIT) or a suspended (SUSP) state. 


If your process has change-mode-to-kernel (CMKRNL) privilege, you can invoke 
SDA to examine the system. Use the following DCL command: 


$ ANALYZE/SYSTEM 


SDA attempts to load SDA$READ_DIR:SYS$BASE_IMAGE.EXE and 
SDA$READ_DIR:REQSYSDEFSTB. It then executes the contents of any 
existing SDA initialization file, as it does when invoked to analyze a crash 
dump (see Sections 2.3.4 and 2.3.5, respectively). SDA subsequently displays its 
identification message and prompt, as follows: 


OpenVMS Alpha System Analyzer 
SDA> 


This prompt indicates that you can use SDA interactively and enter SDA 
commands. When analyzing a running system, SDA sets its process context to 
that of the process running SDA. 


If you are analyzing a running system, consider the following: 


e When used in this mode, SDA does not map the entire system, but instead 
retrieves only the information it needs to process each individual command. 
To update any given display, you must reissue the previous command. 


Caution: 


When using SDA to analyze a running system, carefully interpret its 
displays. Because system states change frequently, it is possible that the 
information SDA displays may be inconsistent with the current state of 
the system. 


e Certain SDA commands are illegal in this mode, such as SET CPU. Use of 
these commands results in the following error message: 


%SDA-E-CMDNOTVLD, command not valid on the running system 


e The SHOW CRASH command, although valid, does not display the contents 
of any of the processor’s set of hardware registers. 


2.5 SDA Context 


When you invoke SDA to analyze either a crash dump or a running system, SDA 
establishes a default context for itself from which it interprets certain commands. 


When you are analyzing a uniprocessor system, SDA’s context is solely process 
context, which means SDA can interpret its process-specific commands in the 
context of either the process current on the uniprocessor or some other process 
in another scheduling state. When SDA is initially invoked to analyze a crash 
dump, SDA’s process context defaults to that of the process that was current 
at the time of the system failure. When you invoke SDA to analyze a running 
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system, SDA’s process context defaults to that of the current process, that is, the 
one executing SDA. To change SDA’s process context, issue any of the following 
commands: 


SET PROCESS process-name 

SET PROCESS/ADDRESS=pcb-address 
SET PROCESS/INDEX=nn 

SET PROCESS/NEXT 

SET PROCESS/SYSTEM 

SHOW PROCESS process-name 

SHOW PROCESS/ADDRESS=pceb-address 
SHOW PROCESS/INDEX=nn 

SHOW PROCESS/SYSTEM 

SHOW PROCESS/NEXT 


When you invoke SDA to analyze a crash dump from a multiprocessing system 
with more than one active CPU, SDA maintains a second dimension of context— 
its CPU context—that allows it to display certain processor-specific information. 
This information includes the reason for the bugcheck exception, the currently 
executing process, the current IPL, and the spinlocks owned by the processor. 
When you invoke SDA to analyze a multiprocessor’s crash dump, its CPU context 
defaults to that of the processor that induced the system failure. When you are 
analyzing a running system, CPU context is not accessible to SDA. Therefore, the 
SET CPU command is not permitted. 


You can change the SDA CPU context by using any of the following commands: 


SET CPU epu-id 

SHOW CPU cpu-id 

SHOW CRASH 

SHOW MACHINE _ CHECK cpu-id 


Changing CPU context involves an implicit change in process context in either of 
the following ways: 


e If there is a current process on the CPU made current, SDA process context 
is changed to that of that CPU’s current process. 


e Ifthere is no current process on the CPU made current, SDA process context 
is undefined and no process-specific information is available until SDA 
process context is set to that of a specific process. 


Changing process context requires a switch of CPU context as well. For instance, 
when you issue a SET PROCESS command, SDA automatically changes its CPU 
context to that of the CPU on which that process was most recently current. The 
following commands can have this effect: 


SET PROCESS process-name 

SET PROCESS/ADDRESS=pcb-address 
SET PROCESS/INDEX=nn 

SET PROCESS/NEXT 

SHOW PROCESS process-name 

SHOW PROCESS/ADDRESS=pceb-address 
SHOW PROCESS/INDEX=nn 

SHOW PROCESS/NEXT 
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2.6 SDA Command Format 


The following sections describe the format of SDA commands and the expressions 
you can use with SDA commands. 


SDA uses a command format similar to that used by the DCL interpreter. Issue 
commands in the following format: 


command-namef/qualifier...] [parameter][/qualifier...] [!comment] 


The command-name is an SDA command. Each command tells the utility to 
perform a function. Commands can consist of one or more words, and can be 
abbreviated to the number of characters that make the command unique. For 
example, SH stands for SHOW. 


The parameter is the target of the command. For example, SHOW PROCESS 
RUSKIN tells SDA to display the context of the process RUSKIN. The command 
EXAMINE 80104CD0;40 displays the contents of 40 bytes of memory, beginning 
with location 80104CD0. 


When you supply part of a file specification as a parameter, SDA assumes 
default values for the omitted portions of the specification. The default device is 
SYS$DISK, the device specified in your most recent SET DEFAULT command. 
The default directory is the directory specified in the most recent SET DEFAULT 
command. See the HP OpenVMS DCL Dictionary for a description of the DCL 
command SET DEFAULT. 


The qualifier modifies the action of an SDA command. A qualifier is always 
preceded by a slash (/). Several qualifiers can follow a single parameter or 
command name, but each must be preceded by a slash. Qualifiers can be 
abbreviated to the shortest string of characters that uniquely identifies the 
qualifier. 


The comment consists of text that describes the command; this comment is 

not actually part of the command. Comments are useful for documenting SDA 
command procedures. When executing a command, SDA ignores the exclamation 
point and all characters that follow it on the same line. 


2.6.1 Using Expressions and Operators 


You can use expressions as parameters for some SDA commands, such as 
SEARCH and EXAMINE. To create expressions, use any of the following 
elements: 


e Numerals 

e Radix operators 

e Arithmetic and logical operators 
e Precedence operators 

e Symbols 


Numerals are one possible component of an expression. The following sections 
describe the use of the other components. 
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2.6.1.1 Radix Operators 


Radix operators determine which numeric base SDA uses to evaluate 
expressions. You can use one of the three radix operators to specify the radix 
of the numeric expression that follows the operator: 


e 6X (hexadecimal) 
e AO (octal) 
e AD (decimal) 


The default radix is hexadecimal. SDA displays hexadecimal numbers with 
leading zeros and decimal numbers with leading spaces. 


2.6.1.2 Arithmetic and Logical Operators 


There are two types of arithmetic and logical operators, both of which are listed 
in Table 2-3. 


e Unary operators affect the value of the expression that follows them. 
e Binary operators combine the operands that precede and follow them. 


In evaluating expressions containing binary operators, SDA performs logical 
AND, OR, and XOR operations, and multiplication, division, and arithmetic 
shifting before addition and subtraction. Note that the SDA arithmetic operators 
perform integer arithmetic on 64-bit operands. 


Table 2-3 SDA Operators 


Operator Action 


Unary Operators 


# Performs a logical NOT of the expression. 
+ Makes the value of the expression positive. 


- Makes the value of the expression negative. 


@ Evaluates the following expression as an address, then uses the 
contents of that address as its value. 

‘Q Specifies that the size of the field to be used as an address is a 
quadword when used with the unary operator @'. 

AL Specifies that the size of the field to be used as an address is a 
longword when used with the unary operator @'. 

AW Specifies that the size of the field to be used as an address is a word 
when used with the unary operator @’. 

AB Specifies that the size of the field to be used as an address is a byte 
when used with the unary operator @'. 

AP Specifies a physical address when used with the unary operator @'. 

AV Specifies a virtual address when used with the unary operator @'. 

G Adds FFFFFFFF 800000006 to the value of the expression”. 


1The command SET FETCH can be used to change the default FETCH size and/or access method. See 
the SET FETCH command description in Chapter 4 for more details and examples. 


2The unary operator G corresponds to the first virtual address in SO system space. For example, the 
expression GD40 can be used to represent the address FFFFFFFF 80000D40j¢. 


(continued on next page) 
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Table 2-3 (Cont.) SDA Operators 


Operator Action 


Unary Operators 
H Adds 7FFE00001¢ to the value of the expression’. 


I Fills the leading digits of the following hexadecimal number with 
hex value of F. For example: 


SDA> eval 180000000 
Hex = FFFFFFFF.80000000 Decimal = -2147483648 G 
SYSS$PUBLIC_VECTORS NPRO 


Binary Operators 


=f Addition 
- Subtraction 
= Multiplication 
& Logical AND 
| Logical OR 
\ Logical XOR 
/ Division* 
@ Arithmetic shifting 


Catenates two 32-bit values into a 64-bit value. For example: 


SDA> eval fe.50000 
Hex = 000000FE00050000 Decimal = 1090922020864 


8The unary operator H corresponds to a convenient base address in P1 space (7FFE0000j¢). You can 
therefore refer to an address such as 7FFE2A641, as H2A64. 


4In division, SDA truncates the quotient to an integer, if necessary, and does not retain a remainder. 


2.6.1.3 Precedence Operators 
SDA uses parentheses as precedence operators. Expressions enclosed in 
parentheses are evaluated first. SDA evaluates nested parenthetical expressions 
from the innermost to the outermost pairs of parentheses. 


2.6.1.4 Symbols 


An SDA symbol can represent several value types. It can represent a constant, 
a data address, a procedure descriptor address, or a routine address. Constants 
are usually offsets of a particular field in a data structure; however, they can also 
represent constant values such as the BUG$_xxx symbols. 


Symbols are composed of up to 31 letters and numbers, and can include the dollar 
sign ($) and underscore (_) characters. When you invoke SDA, it reads in the 
global symbols from the symbols table section of SYS$BASE_IMAGE.EXE, and 
from REQSYSDEF:STB, a required subset of the symbols in the file SYSDEF.STB. 
You can add other symbols to SDA’s symbol table by using the DEFINE and 
READ commands. 


All address symbols identify memory locations. SDA generally does not 
distinguish among different types of address symbols. However, for a symbol 
identified as the name of a procedure descriptor, SDA takes an additional step 
of creating an associated symbol to name the code entry point address of the 
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procedure. It forms the code entry point symbol name by appending _C to the 
name of the procedure descriptor. 


Also, SDA substitutes the code entry point symbol name for the procedure 
descriptor symbol when you enter the following command: 


SDA> EXAMINE/INSTRUCTION procedure descriptor 
For example, enter the following command: 
SDA> EXAMINE/INSTRUCTION SCHSQAST 

SDA displays the following information: 
SCHSOAST C: SUBQ SP, #X40,SP 


Now enter the EXAMINE command but do not specify the /INSTRUCTION 
qualifier, as follows: 


SDA> EXAMINE SCHSQAST 
SDA displays the following information: 
SCHSQAST: 0000002C.00003009 wie Oe arp shace« 


This display shows the contents of the first two longwords of the procedure 
descriptor. 


Note that there are no routine address symbols on Alpha systems, except for 
those in MACRO-64 assembly language modules. Therefore, SDA creates a 
routine address symbol for every procedure descriptor it has in its symbol table. 
The new symbol name is the same as for the procedure descriptor except that it 
has an _C appended to the end of the name. 


Sources for SDA Symbols 
SDA obtains its information from the following: 


e Images (.EXE files) 
e Image symbol table files (.STB files) 
e Object files 


SDA also defines symbols to access registers and to access common data 
structures. 


The only images with symbols are shareable images and executive images. These 
images contain only universal symbols, such as constants and addresses. 


The image symbol table files are produced by the linker with the /SYMBOLS 
qualifier. These files normally only contain universal symbols, as do the 
executable images. However, if the SYMBOL_TABLE=GLOBALS linker option is 
specified, the .STB file also contains all global symbols defined in the image. See 
the HP OpenVMS Linker Utility Manual for more information. 


Object files can contain global constant values. An object file used with SDA 
typically contains symbol definitions for data structure fields. Such an object file 
can be generated by compiling a MACRO-32 source module that invokes specific 
macros. The macros, which are typically defined in SYS$LIBRARY:LIB.MLB or 
STARLET.MLB, define symbols that correspond to data structure field offsets. 
The macro $UCBDEF, for example, defines offsets for fields within a unit control 
block (UCB). OpenVMS Alpha and I64 provide several such object modules in 
SDA$READ_DIR, as listed in Table 2-4. For compatibility with OpenVMS VAX, 
the modules’ file types have been renamed to .STB. 
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Table 2-4 Modules Containing SDA Global Symbols and Data Structures 


File Contents 

DCLDEF.STB Symbols for the DCL interpreter 

DECDTMDEF.STB Symbols for transaction processing 

GLXDEF.STB Symbols for OpenVMS Galaxy data structures 

IMGDEF.STB Symbols for the image activator 

IODEF.STB I/O database structure symbols 

NETDEF.STB Symbols for DECnet data structures 

REQSYSDEF.STB Required symbols for SDA 

RMSDEF.STB Symbols that define RMS internal and user data 
structures and RMS$_xxx completion codes 

SCSDEF.STB Symbols that define data structures for system 
communications services 

SYSDEF.STB Symbols that define system data structures, including 


the I/O database 


TCPIP$NET_GLOBALS.STB? Data structure definitions for TCP/IP internet driver, 


execlet, and ACP data structures 


TCPIP$NFS_GLOBALS.STB! Data structure definitions for TCP/IP NFS server 


TCPIP$PROXY_ 
GLOBALS.STB! 


Data structure definitions for TCP/IP proxy execlet 


TCPIP$PWIP_GLOBALS.STB! Data structure definitions for TCP/IP PWIP driver, and 


TCPIP$TN_GLOBALS.STB? 


ACP data structures 


Data structure definitions for TCP/IP TELNET/RLOGIN 
server driver data structures 


1Only available if TCP/IP has been installed. These are found in SYS$SYSTEM, so that all files are 
not automatically read in when you issue a READ/EXEC command. 


Table 2-5 lists symbols that SDA defines automatically on initialization. 


Table 2-5 SDA Symbols Defined on Initialization 


ASN 
AST 


BRO through BR7 
CYCLE_COUNTER 
ESP 

EBSP 

FEN 

FP 

FPO through FP31 
FPO through FP127 


Address space number 


Both the asynchronous system trap status and enable 
registers: AST<3:0> = AST enable; AST<7:4> = AST status 


Branch registers” 

Process cycle counter 

Executive stack pointer 
Executive register stack pointer” 
Floating-point enable 

Frame pointer (R29) 
Floating-point registers ! 


Floating point registers” 


1Alpha only. 
2164 only. 
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Table 2—5 (Cont.) SDA Symbols Defined on Initialization 


FPCR 
FPSR 
GP 

G 


PS 

PTBR 

RO through R31 
RO through R127 
SCC 


Floating-point control register? 

Floating-point status register” 

Global pointer (R1)” 

FFFFFFFF.80000000,., the base address of system space 
00000000.7FFE0000i¢, a base address in P1 space 


FFFFFFFF.FFFFFFFF¢, also fills the leading digits of a 
hexadecimal number with the value of F 


Kernel stack pointer 

Kernel register stack pointer” 

PAL reserved area in process HWPCB 
Program counter 

Process cycle counter 

Processor status 

Page table base register 

Integer registers! 

Integer registers 7 


System cycle counter 


SP Current stack pointer of a process 

SSP Supervisor stack pointer 

SBSP Supervisor register stack pointer ” 
SYSPTBR Page table base register for system space 
USP User stack pointer 

UBSP User register stack pointer” 

VIRBND Virtual Address Boundary for RADs? 
1Alpha only. 

2164 only. 


After a SET CPU command is issued (for analyzing a crash dump only), the 
symbols defined in Table 2-6 are set for that CPU. 


Table 2-6 SDA Symbols Defined by SET CPU Command 


CPUDB 
IPL 
MCES 
PCBB 
PRBR 
RAD 
SCBB 
SISR 


Address of CPU database 

Interrupt priority level register 

Machine check error summary register 

Process context block base register 

Processor base register (CPU database address) 
Address of RAD database 

System control block base register 

Software interrupt status register 


(continued on next page) 
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Table 2-6 (Cont.) SDA Symbols Defined by SET CPU Command 


VPTB Virtual Page Table Base register 


After a SET PROCESS command is issued, the symbols listed in Table 2—7 are 
defined for that process. 


Table 2-7 SDA Symbols Defined by SET PROCESS Command 


ARB Address of access rights block 

FRED Address of floating-point register and execution data block 
JIB Address of job information block 

KTB Address of the kernel thread block 

ORB Address of object rights block 

PCB Address of process control block 

PHD Address of process header 

PSB Address of persona security block 


Other SDA commands, such as SHOW DEVICE and SHOW CLUSTER, predefine 
additional symbols. 


SDA Symbol Initialization 

On initialization, SDA reads the universal symbols defined by SYS$BASE_ 
IMAGE.EXE. For every procedure descriptor address symbol found, a routine 
address symbol is created (with _C appended to the symbol name). 


SDA then reads the object file REQSYSDEF:‘STB. This file contains data structure 
definitions that are required for SDA to run correctly. It uses these symbols to 
access some of the data structures in the crash dump file or on the running 
system. 


Finally, SDA initializes the process registers defined in Table 2-7 and executes a 
SET CPU command, defining the symbols as well. 


Use of SDA Symbols 


There are two major uses of the address type symbols. First, the EXAMINE 
command employs them to find the value of a known symbol. For example, 
EXAMINE CTL$GL_PCB finds the PCB for the current process. Then, certain 
SDA commands (such as EXAMINE, SHOW STACK, and FORMAT) use them to 
symbolize addresses when generating output. 


When the code for one of these commands needs a symbol for an address, it calls 
the SDA symbolize routine. The symbolize routine tries to find the symbol in 
the symbol table whose address is closest to, but not greater than the requested 
address. This means, for any given address, the routine may return a symbol of 
the form symbol_name+offset. If, however, the offset is greater than OFFF yg, it 
fails to find a symbol for the address. 


As a last resort, the symbolize routine checks to see if this address falls within a 
known memory range. Currently, the only known memory ranges are those used 
by the OpenVMS executive images and those used by active images in a process. 
SDA searches through the executive loaded image list (LDRIMG data structure) 
to see if the address falls within any of the image sections. If SDA does find a 
match, it returns one of the following types of symbols: 
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executive_image_name-+offset 
activated_image_name+offset 


The offset is the same as the image offset as defined in the map file. 


The constants in the SDA symbol table are usually used to display a data 
structure with the FORMAT command. For example, the PHD offsets are 
defined in SYSDEF.STB; you can display all the fields of the PHD by entering the 
following commands: 


SDA> READ SDASREAD_DIR:SYSDEF.STB 
SDA> FORMAT/TYPE=PHD phd_address 


Symbols and Address Resolution 

In OpenVMS, executive and user images are loaded into dynamically assigned 
address space. To help you associate a particular virtual address with the image 
whose code has been loaded at that address, SDA provides several features: 


e The SHOW EXECUTIVE command 

e The symbolization of addresses, described in the previous section 
e The READ command 

e The SHOW PROCESS command with the /IMAGES qualifier 

e The MAP command 


The OpenVMS executive consists of two base images, SYS$BASE_IMAGE.EXE 
and SYS$PUBLIC_VECTORS.EXE, and a number of other separately loadable 
images. Some of these images are loaded on all systems, while others support 
features unique to particular system configurations. Executive images are 
mapped into system space during system initialization. 


By default, a typical executive image is not mapped at contiguous virtual 
addresses. Instead, its nonpageable image sections are loaded into a reserved 
set of pages with other executive images’ nonpageable sections. The pageable 
sections of a typical executive image are mapped contiguously into a different 
part of system space. An image mapped in this manner is said to be sliced. A 
particular system may have system parameters defined that disable executive 
image slicing altogether. 


Each executive image is described by a data structure called a loadable image 
data block (LDRIMG). The LDRIMG specifies whether the image has been 
sliced. If the image is sliced, the LDRIMG indicates the beginning of each image 
section and the size of each section. All the LDRIMGs are linked together in a 
list that SDA scans to determine what images have been loaded and into what 
addresses they have been mapped. The SHOW EXECUTIVE command displays a 
list of all images that are included in the OpenVMS executive. 


Each executive image is a shareable image whose universal symbols are defined 
in the SYS$BASE_IMAGE.EXE symbol vector. On initialization, SDA reads this 
symbol vector and adds its universal symbols to the SDA symbol table. 


Executive image .STB files define additional symbols within an executive image 
that are not defined as universal symbols and thus are not in the SYS$BASE_ 
IMAGE.EXE symbol vector (see Sources for SDA Symbols in this section). You 
can enter a READ/EXECUTIVE command to read symbols defined in all executive 
image .STB files into the SDA symbol table, or a READ/IMAGE filespec command 
to read the .STB for a specified image only. 
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To obtain a display of all images mapped within a process, execute a SHOW 
PROCESS/IMAGE command. See the description of the SHOW PROCESS 
command for additional information about displaying the hardware and software 
context of a process. 


You can also identify the image name and offset that correspond to a specified 
address with the MAP command. With the information obtained from the MAP 
command, you can then examine the image map to locate the source module and 
program section offset corresponding to an address. 


2.6.2 SDA Display Mode 


Some SDA commands produce more output than will fit on one screen. In this 
situation, SDA enters display mode, and outputs the screen overflow prompt 
at the bottom of the screen: 


Press RETURN for more. 
SDA> 


If the RETURN key is pressed, SDA will continue the output of the command it 
was processing. If an EXIT command is entered, SDA will leave display mode, 
abort the command it was processing and output a regular SDA prompt. If any 
other command is entered, SDA will leave display mode, abort the command it 
was processing, and begin processing the new command. 


SDA will leave display mode once a continued command completes. 


2.7 Investigating System Failures 


This section discusses how the operating system handles internal errors, and 
suggests procedures that can help you determine the causes of these errors. It 
illustrates, through detailed analysis of a sample system failure, how SDA helps 
you find the causes of operating system problems. 


For a complete description of the commands discussed in the sections that follow, 
refer to Chapter 4 and Chapter 5 of this document, where all the SDA and CLUE 
commands are presented in alphabetical order. 


2.7.1. Procedure for Analyzing System Failures 


When the operating system detects an internal error so severe that normal 
operation cannot continue, it signals a condition known as a fatal bugcheck and 
shuts itself down. A specific bugcheck code describes each fatal bugcheck. 


To resolve the problem, you must find the reason for the bugcheck. Many failures 
are caused by errors in user-written device drivers or other privileged code not 
supplied by HP. To identify and correct these errors, you need a listing of the code 
in question. 


Occasionally, a system failure is the result of a hardware failure or an error in 
code supplied by HP. A hardware failure requires the attention of HP Services. 
To diagnose an error in code supplied by HP, you need listings of that code, which 
are available from HP. 


Start the search for the error by analyzing the CLUE list file that was created by 
default when the system failed. This file contains an overview of the system 
failure, which can assist you in finding the line of code that signaled the 
bugcheck. CLUE CRASH displays the content of the program counter (PC) 

in the list file. The content of the PC is the address of the next instruction after 
the instruction that signaled the bugcheck. 
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However, some bugchecks are caused by unexpected exceptions. In such cases, 
the address of the instruction that caused the exception is more informative than 
the address of the instruction that signaled the bugcheck. 


The address of the instruction that caused the exception is located on the stack. 
You can obtain this address either by using the SHOW STACK command to 
display the contents of the stack or by using the SHOW CRASH or CLUE CRASH 
command to display the system state at time of exception. See Section 2.7.2 for 
information on how to proceed for several types of bugchecks. 


Once you have found the address of the instruction that caused the bugcheck 
or exception, find the module in which the failing instruction resides. Use the 
MAP command to determine whether the instruction is part of a device driver or 
another executive image. Alternatively, the SHOW EXECUTIVE command shows 
the location and size of each of the images that make up the OpenVMS executive. 


If the instruction that caused the bugcheck is not part of a driver or executive 
image, examine the linker’s map of the module or modules you are debugging to 
determine whether the instruction that caused the bugcheck is in your program. 


To determine the general cause of the system failure, examine the code that 
signaled the bugcheck or the instruction that caused the exception. 


2.7.2 Fatal Bugcheck Conditions 


There are many possible conditions that can cause OpenVMS to issue a bugcheck. 
Normally, these occasions are rare. When they do occur, they are often fatal 
exceptions or illegal page faults occurring within privileged code. This section 
describes the symptoms of several common bugchecks. A discussion of other 
exceptions and condition handling in general appears in the HP OpenVMS 
Programming Concepts Manual. 


An exception is fatal when it occurs while either of the following conditions exists: 
e The process is executing above IPL 2 (IPL$_ASTDEL). 


e The process is executing in a privileged (kernel or executive) processor access 
mode and has not declared a condition handler to deal with the exception. 


When the system fails, the operating system reports the approximate cause of the 
system failure on the console terminal. SDA displays a similar message when 
you issue a SHOW CRASH command. For instance, for a fatal exception, SDA 
can display one of these messages: 

FATALEXCPT, Fatal executive or kernel mode exception 

INVEXCEPTN, Exception while above ASTDEL 

SSRVEXCEPT, Unexpected system service exception 

UNXSIGNAL, Unexpected signal name in ACP 

When a FATALEXCPT, INVEXCEPTN, SSRVEXCEPT, or UNXSIGNAL bugcheck 


occurs, two argument lists, known as the mechanism and signal arrays, are 
placed on the stack. 


Section 2.7.2.1 to Section 2.7.2.5 describe these arrays and related data 
structures, and Section 2.7.2.7 shows example output from SDA for an 
SSRVEXCEPT bugcheck. 
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A page fault is illegal when it occurs while the interrupt priority level (IPL) is 
greater than 2 (IPL$_ASTDEL). When OpenVMS fails because of an illegal page 
fault, it displays the following message on the console terminal: 


PGFIPLHI, Page fault with IPL too high 


Section 2.7.2.8, Illegal Page Faults describes the stack contents when an illegal 
page fault occurs. 


2.7.2.1. Alpha Mechanism Array 


Figure 2-1 illustrates the Alpha mechanism array, which is made up 
entirely of quadwords. The first quadword of this array indicates the number 

of quadwords in this array; this value is always 2C;g. These quadwords are used 
by the procedures that search for a condition handler and report exceptions. 
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mechanism_args quadword aligned 


MCH_ARGS 


MCH_FLAGS 


MCH_FRAME 


MCH_DEPTH 


MCH_RESVD1 


MCH_DADDR 


MCH_ESF_ADDR 


MCH_SIG_ADDR 


MCH_SAVRO 48 
MCH_SAVRO_LOW 
MCH_SAVRO_HIGH 
MCH_SAVR1 56 
MCH_SAVR1_LOW 
MCH_SAVR1_HIGH 
164 
MCH_SAVR16 
Integer registers 17-27 
160 
MCH_SAVR28 
168 
MCH_SAVFO 
1176 
MCH_SAVF1 
184 
MCH_SAVF10 


Floating registers 11-29 


"344 
MCH_SAVF30 


1352 


MCH_SIG64_ADDR 


CHF$S_CHFDEF2 = 360 
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Symbolic offsets into the mechanism array are defined by using the SDA SHOW 
STACK command to identify the elements of the mechanism array on the stack 


using the symbols in Table 2-8. 


Table 2-8 Contents of the Alpha Mechanism Array 


Offset 


Meaning 


CHF$IS_MCH_ARGS 


CHF$IS_MCH_FLAGS 
CHF$PH_MCH_FRAME 


CHF$IS_MCH_DEPTH 
CHF$PH_MCH_DADDR 


CHF$PH_MCH_ESF_ADDR 
CHF$PH_MCH_SIG_ADDR 
CHF$IH_MCH_SAVRnn 


CHF$FH_MCH_SAVFnn 


CHF$PH_MCH_SIG64_ADDR 


2.7.2.2 164 Mechanism Array 


Number of quadwords that follow. In a mechanism 
array, this value is always 2C4¢. 


Flag bits for related argument mechanism information. 


Address of the FP (frame pointer) of the establisher’s 
call frame. 


Depth of the OpenVMS search for a condition handler. 


Address of the handler data quadword, if the exception 
handler data field is present. 


Address of the exception stack frame (see Figure 2-5). 
Address of the signal array (see Figure 2-3). 


Contents of the saved integer registers at the time of 
the exception. The following registers are saved: RO, 
R1, and R16 to R28 inclusive. 


If the process was using floating point, contents of 
the saved floating-point registers at the time of the 
exception. The following registers are saved: FO, F1, 
and F10 to F30 inclusive. 


Address of the 64-bit signal array (see Figure 2-4). 


Figure 2—2 illustrates the 164 mechanism array, which is made up entirely of 
quadwords. The first quadword of this array indicates the number of quadwords 
in the array. This value is either 49 g, if floating point registers F32 to F127 have 
not been saved, or 1094¢, if the floating point registers have been saved. These 
quadwords are used by the procedures that search for a condition handler and 


report exceptions. 
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Figure 2-2 164 Mechanism Array 


octaword aligned 


moe 
[ermnee | 
[enone | 
[ermecer| 
[sree | 
[orc | 
[ermaan_| 
[erroncnn | 
[creo | 
[erromumme —| 
[omen | 
[eran | 
[eccrine | 
[semanas | 


CHF$FH_MCH_SAVF2 
CHF$FH_MCH_SAVF5 
CHF$FH_MCH_SAVF12 
CHF$FH_MCH_SAVF31 
CHF$IH_MCH_SAVB1 


CHF$IH_MCH_SAVB5 


[emcee | 
[era | 
[erro | 
[errcctas | 
[ena | 
[eens | 
[ernie | 


CHF$S_CHFDEF2=592 


VM-1082A-Al 


Symbolic offsets into the mechanism array are defined by using the SDA SHOW 
STACK command to identify the elements of the mechanism array on the stack 
using the symbols in Table 2-9. 
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Table 2-9 Contents of the 164 Argument Mechanism Array 


Field Name 


Contents 


CHF$IS_MCH_ARGS 


CHF$IS_MCH_FLAGS 
CHF$PH_MCH_FRAME 


CHF$IS_MCH_DEPTH 


CHF$PH_MCH_DADDR 


CHF$PH_MCH_ESF_ADDR 
CHF$PH_MCH_SIG_ADDR 


CHF$IH_MCH_RETVAL 
CHF$IH_MCH_RETVAL2 
CHF$PH_MCH_SIG64_ADDR 


CHF$FH_MCH_SAVF32_SAVF127 


CHF$FH_MCH_RETVAL_FLOAT 
CHF$FH_MCH_RETVAL2_FLOAT 
CHF$FH_MCH_SAVFnn 


CHF$IH_MCH_SAVBnn 
CHF$IH_MCH_AR_LC 
CHF$IH_MCH_AR_EC 
CHF$PH_MCH_OSSD 
CHF$PH_MCH_INVO_HANDLE 
CHF$PH_MCH_UWR_START 
CHF$IH_MCH_FPSR 


CHF$IH_MCH_FPSS 


Count of quadwords in this array starting from the next quadword, CHF$PH_ 
MCH_FRAME (not counting the first quadword that contains this longword). 
This value is 73 if CHF$V_FPREGS2_VALID is clear, and 265 if CHF$V_ 
FPREGS2_VALID is set. 


Flag bits for related argument-mechanism information. 


Contains the Previous Stack Pointer, PSP, (the value of the SP at procedure 
entry) for the procedure context of the establisher. 


Positive count of the number of procedure activation stack frames between the 
frame in which the exception occurred and the frame depth that established the 
handler being called. 


Address of the handler data quadword (start of the Language Specific Data area, 
LSDA), if the exception handler data field is present in the unwind information 
block (as indicated by OSSD$V_HANDLER_DATA_VALID); otherwise, contains 0. 


Address of the exception stack frame. 


Address of the 32-bit form of signal array. This array is a 32-bit wide (longword) 
array. This is the same array that is passed to a handler as the signal argument 
vector. 


Contains a copy of R8 at the time of the exception. 
Contains a copy of R9 at the time of the exception. 


Address of the 64-bit form of signal array. This array is a 64-bit wide (quadword) 
array. 


Address of the extension to the mechanism array that contains copies of F32 to 
F127 at the time of the exception. 


Contains a copy of F8 at the time of the exception. 
Contains a copy of F9 at the time of the exception. 


Contain copies of floating-point registers F2 to F5 and F12 to F31. Registers F6, 
F7 and F10, F11 are implicitly saved in the exception frame. 


Contain copies of branch registers B1 to B5 at the time of the exception. 
Contains a copy of the Loop Count Register (AR65) at the time of the exception. 
Contains a copy of the Epilog Count Register (AR66) at the time of the exception. 
Address of the operating-system specific data area. 

Contains the invocation handle of the procedure context of the establisher. 
Address of the unwind region. 


Contains a copy of the hardware floating-point status register (AR.FPSR) at the 
time of the exception. 


Contains a copy of the software floating-point status register (which supplements 
CHF$IH_MCH_FPSR) at the time of the exception. 


2.7.2.3 Signal Array 


The signal array appears somewhat further down the stack. This array 
comprises all longwords so that the structure is VAX compatible. A signal 

array describes the exception that occurred. It contains an argument count, the 
exception code, zero or more exception parameters, the PC, and the PS. Therefore, 
the size of a signal array can vary from exception to exception. Although there 
are several possible exception conditions, access violations are most common. 
Figure 2-3 shows the signal array for an access violation. 
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Figure 2-3 Signal Array 


31 0 


Vector count (n) :-CHF$IS_SIG_ARGS 


Condition value :CHF$L_SIG_NAME 


Additional arguments (or none) 


PC 
L PS 


ZK-4643A-GE 


For access violations, the signal array is set up as follows: 


Value Meaning 


Vector list length Number of longwords that follow. For access violations, this 
value is always 5. 


Condition value Exception code. The value 0Ci¢ represents an access violation. 
You can identify the exception code by using the SDA command 
EVALUATE/CONDITION_VALUE or SHOW CRASH. 


Additional arguments These can include a reason mask and a virtual address. 


In the longword mask if bit 0 of the longword is set, the failing 
instruction (at the PC saved below) caused a length violation. 
If bit 1 is set, it referred to a location whose page table entry is 
in a “no access” page. Bit 2 indicates the type of access used by 
the failing instruction: it is set for write and modify operations 
and clear for read operations. 


The virtual address represents the low-order 32 bits of the 
virtual address that the failing instruction tried to reference. 


PC PC whose execution resulted in the exception. 
PS PS at the time of the exception. 
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2.7.2.4 64-Bit Signal Array 


The 64-bit signal array also appears further down the stack. This array 
comprises all quadwords and is not VAX compatible. It contains the same data 
as the signal array, and Figure 2—4 shows the 64-bit signal array for an access 
violation. The SDA SHOW STACK command uses the CHF64$ symbols listed in 
the figure to identify the 64-bit signal array on the stack. 


Figure 2-4 64-Bit Signal Array 


63 0 


SS$_SIGNAL_64 (2604 


16) Vector count (n) :-CHF64$L_SIG_ARGS 


Condition value :CHF64$Q_SIG_NAME 


Additional arguments (or none) 


n 
a 


ZK-8960A-GE 
For access violations, the 64-bit signal array is set up as follows: 
Value Meaning 
Vector list length Number of quadwords that follow. For access violations, this 
value is always 5. 
Condition value Exception code. The value 0Cig represents an access violation. 


You can identify the exception code by using the SDA command 
EVALUATE/CONDITION_VALUE or SHOW CRASH. 


Additional arguments These can include a reason mask and a virtual address. 


In the quadword mask if bit 0 of the quadword is set, the 
failing instruction (at the PC saved below) caused a length 
violation. If bit 1 is set, it referred to a location whose page 
table entry is in a “no access” page. Bit 2 indicates the type 
of access used by the failing instruction: it is set for write and 
modify operations and clear for read operations. 


PC PC whose execution resulted in the exception. 
PS PS at the time of the exception. 
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2.7.2.5 Alpha Exception Stack Frame 


Figure 2-5 illustrates the Alpha exception stack frame, which comprises all 
quadwords. 


Figure 2-5 Alpha Exception Stack Frame 


63 0 


ZK-6788A-GE 
The values contained in the exception stack frame are defined as follows: 
Table 2-10 Alpha Exception Stack Frame Values 
Value Contents 
INTSTK$Q_R2 Contents of R2 at the time of the exception 
INTSTK$Q_R3 Contents of R3 at the time of the exception 
INTSTK$Q_R4 Contents of R4 at the time of the exception 
INTSTK$Q_R5 Contents of R5 at the time of the exception 
INTSTK$Q_R6 Contents of R6 at the time of the exception 
INTSTK$Q_R7 Contents of R7 at the time of the exception 
INTSTK$Q_PC PC whose execution resulted in the exception 
INTSTK$Q_PS PS at the time of the exception (except high-order bits) 


The SDA SHOW STACK command identifies the elements of the exception stack 
frame on the stack using these symbols. 


2.7.2.6 164 Exception Stack Frame 
Figure 2-6 and Figure 2—7 illustrate the 164 exception stack frame. 
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Figure 2-6 164 Exception Stack Frame 
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Figure 2-7 164 Exception Stack Frame (cont.) 
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The values contained in the exception stack frame are defined in Table 2-11. 


Table 2-11 164 Exception Stack Frame Values 


Field Use 

INTSTK$B_FLAGS Indicates if certain registers have been saved. 
INTSTK$B_PPREVMODE Save interrupted context’s PREVMODE. 
INTSTK$B_PREVSTACK Indicates which mode of stack (register and memory) we return to. 
INTSTK$B_IPL SWIS IPL state 

INTSTK$L_STKALIGN How much allocated on this stack for exception frame. 
INTSTK$W_NATMASK Mask of bits 3-9 of the exception frame address. 
INTSTK$B_TYPE Standard VMS structure type. 

INTSTK$B_SUBTYPE Standard VMS structure subtype. 
INTSTK$L_TRAP_TYPE Trap type. 

INTSTK$Q_IIP Interruption Instruction Pointer (CR19). 
INTSTK$Q_RSC Register Stack Control register. 

INTSTK$Q_BSP Backing store pointer. 

INTSTK$Q_BSPSTORE User BSP store pointer for next spill. 
INTSTK$Q_RNAT RNAT register. 

INTSTK$Q_BSPBASE Base of backing store for the inner mode. 
INTSTK$Q_PFS Previous function state. 


(continued on next page) 
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Table 2-11 (Cont.) 164 Exception Stack Frame Values 


Field 


Use 


INTSTK$Q_ CONTEXT 


INTSTK$Q_AST_F12 through 
INTSTK$Q_AST_F15 


INTSTK$Q_ FPSR 


INTSTK$B_INTERRUPT_DEPTH 


INTSTK$Q_PREDS 
INTSTK$Q_IPSR 
INTSTK$Q_ISR 
INTSTK$Q_CR18 
INTSTK$Q_IFA 
INTSTK$Q_ITIR 
INTSTK$Q_ ITPA 
INTSTK$Q_ IFS 
INTSTK$Q_IIM 
INTSTK$Q_ IHA 
INTSTK$Q_UNAT 
INTSTK$Q_ CCV 
INTSTK$Q_ DCR 
INTSTK$Q_LC 
INTSTK$Q_EC 
INTSTK$Q_ NATS 
INTSTK$Q_REGBASE 
INTSTK$Q_GP 
INTSTK$Q_R2 
INTSTK$Q_R3 
INTSTK$Q_R4 through R7 
INTSTK$Q_R8 
INTSTK$Q_R9 
INTSTK$Q_R10 
INTSTK$Q R11 
INTSTK$Q_SSD 
INTSTK$Q_R13 
INTSTK$Q_R14 through R31 
INTSTK$Q_BO 
INTSTK$Q_B1 through B5 
INTSTK$Q_B6 
INTSTK$Q_B7 
INTSTK$L_IVT_OFFSET 
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Bookkeeping data for exception processing. 


F12 to F15 - temporary FP registers; sometimes saved by AST. 


Floating point status register. 

Interrupt depth. 

Predication registers. 

Interruption Processor Status (CR16). 
Interruption Status Register (CR17). 
Reserved control register. 

Interruption Fault Address (CR20). 
Interruption TLB Insertion Register (CR21). 
Interruption immediate register (CR22). 
Interruption Function State (CR23). 
Interruption immediate (CR24). 
Interruption Hash Address (CR25). 

User NAT collection register. 

CCV register. 

Default control register. 

Loop counter. 

Epilogue counter. 

NATs for registers saved in this structure. 
Used to index into registers. 

rl - Used as global pointer. 

r2 - temporary register. 

r3 - temporary register. 

r4 through r7 - preserved registers (not saved by interrupt). 
r8 - return value. 

r9 - argument pointer. 

r10 - temporary register. 

rll - temporary register. 

For future use. 

r13 - Thread Pointer. 

r14 through r31 - temporary registers. 
Return pointer on kernel entry. 

b1 through b5 - Preserved branch registers (not saved by interrupt). 
b6 - temporary branch register. 

b7 - temporary branch register. 

Offset in IVT. 
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Table 2-11 (Cont.) 164 Exception Stack Frame Values 
Field Use 


INTSTK$Q_F6 through F11 f6 through f11 - temporary FP registers. 


2.7.2.7 SSRVEXCEPT Example 


If OpenVMS encounters a fatal exception, you can find the code that signaled 

it by examining the PC in the signal array. Use the SHOW CRASH or CLUE 
CRASH command to display the PC and the instruction stream around the PC to 
locate the exception. 


The following display shows the SDA output in response to the SHOW CRASH 
and SHOW STACK commands for an Alpha SSRVEXCEPT bugcheck. It 
illustrates the mechanism array, signal arrays, and the exception stack frame 
previously described. 


Example 2-1 SHOW CRASH 


OpenVMS (TM) Alpha system dump analyzer 
...analyzing a selective memory dump... 


Dump taken on 30-AUG-2000 13:13:46.83 
SSRVEXCEPT, Unexpected system service exception 


SDA> SHOW CRASH 

Time of system crash: 30-AUG-1996 13:13:46.83 

Version of system: OpenVMS (TM) Alpha Operating System, Version V7.3 
System Version Major ID/Minor ID: 3/0 


System type: DEC 3000 Model 400 
Crash CPU ID/Primary CPU ID: 00/00 
Bitmask of CPUs active/available: 00000001/00000001 
CPU bugcheck codes: 
CPU 00 -- SSRVEXCEPT, Unexpected system service exception 


System State at Time of Exception 


R2 = 00000000.00000003 

R3 = FFFFFFFF.80C63460 EXCEPTION MON NPRW+06A60 
R4 = FFFFFFFF.80D12740 PCB — 

R5 = 00000000.000000C8 

R6 = 00000000.00030038 

R7 = 00000000. 7FFA1FCO 

PC = 00000000.00030078 

PS = 00000000.00000003 
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Example 2-1 (Cont.) SHOW CRASH 


00000000.00030068: STQ R27, (SP) 
00000000.0003006C: BIS R31,SP,FP 
00000000.00030070: STO R26, #X0010(SP) 
00000000.00030074: LDA R28, (R31) 

PC => 00000000.00030078: LDL R28, (R28) 
00000000.0003007C: BEQ R28 , #X000007 
00000000.00030080: LDQ R26, #XFFE8 (R27) 
00000000.00030084: BIS R31,R26,R0 
00000000.00030088: BIS R31,FP,SP 

PS => 
MBZ SPAL MBZ IPL VMM MBZ CURMOD INT PRVMOD 


0 00 00000000000 00 0 0 KERN 0 - USER 


Signal Array 


Length = 00000005 
Type = 0000000C 
Arg = 00000000.00010000 
Arg = 00000000.00000000 
Arg = 00000000.00030078 
Arg = 00000000.00000003 


SSYSTEM-F-ACCVIO, access violation, reason mask=00, virtual address=0000000000000000, 
PC=0000000000030078, PS=00000003 


Saved Scratch Registers in Mechanism Array 


RO = 00000000.00020000 R1 = 00000000.00000000 R16 = 00000000.00020004 
R17 = 00000000.00010050 R18 = FFFFFFFF.FFFFFFFF R19 = 00000000.00000000 
R20 = 00000000.7FFAIF50 R21 = 00000000.00000000 R22 = 00000000.00010050 
R23 = 00000000.00000000 R24 = 00000000.00010051 R25 = 00000000.00000000 
R26 = FFFFFFFF.8010ACA4 R27 = 00000000.00010050 R28 = 00000000.00000000 


CPU 00 Processor crash information 


CPU 00 reason for Bugcheck: SSRVEXCEPT, Unexpected system service exception 
Process currently executing on this CPU: SYSTEM 

Current image file: $31SDKB0:[SYS0.][SYSMGR]X.EXE;1 

Current IPL: 0 (decimal) 

CPU database address: 80D0E000 


CPUs Capabilities: PRIMARY , QUORUM, RUN 


General registers: 


RO = 00000000.00000000 R1 = 00000000.7FFAIEB8 R2 = FFFFFFFF.80D0E6C0 
R3 = FFFFFFFF.80C63460 R4 = FFFFFFFF.80D12740 R5 = 00000000.000000C8 
R6 == 00000000.00030038 R7 = 00000000.7FFAIFCO R8& = 00000000.7FFAC208 
RI == 00000000.7FFAC410 R10 = 00000000.7FFAD238 R11 = 00000000. 7FFCE3E0 
R12 = 00000000.00000000 R13 = FFFFFFFF.80C6EB60 R14 = 00000000.00000000 
R15 = 00000000.009A79FD R16 = 00000000.000003C4 R17 = 00000000. 7FFA1D40 
R18 = FFFFFFFF.80C05C38 R19 = 00000000.00000000 R20 = 00000000. 7FFAI1F50 
R21 = 00000000.00000000 R22 = 00000000.00000001 R23 = 00000000. 7FFF03C8 
R24 = 00000000.7FFF0040 AI = 00000000.00000003 RA = FFFFFFFF.82A21080 
PV = FFFFFFFF.829CF010 R28 = FFFFFFFF.8004B6DC FP = 00000000.7FFA1CA0 
PC = FFFFFFFF.82A210B4 PS = 18000000.00000000 
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Processor Internal Registers: 


00000000 PCBB 


ASN = 00000000.0000002F 

IPL = 

PTBR = 00000000.00001136 SCBB 
VPTB = FFFFFFFC.00000000 FPCR 


CPU 00 Processor crash information 


00000000. 7FFA1C98 
00000000. 7FFA6000 
00000000. 7FFAC100 
00000000. 7AFFBADO 


ASTSR/ASTEN 
00000000.003FE080 PRBR 
00000000.000001DC SISR 
00000000.00000000 MCES 


SDA Description 


2.7 Investigating System Failures 


No spinlocks currently owned by CPU 00 


Example 2-2 SHOW STACK 


SDA> SHOW STACK 


Current Operating Stack (KERNEL): 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 


SP => 


CHF$IS MCH ARGS 
CHF$PH MCH FRAME 
CHFSIS MCH DEPTH 
CHF$PH MCH DADDR 
CHFSPH MCH ESF ADDR 
CHF$PH MCH SIG ADDR 
CHFSIH MCH SAVRO 
CHF$IH MCH SAVR1 
CHFSIH MCH SAVR16 
CHF$IH_MCH_SAVR17 


7FFA1C78 
7FFA1C80 
7FFA1C88 
7FFA1C90 
7FFA1C98 
7FFA1CA0 
7FFA1CA8 
7FFA1CBO 
7FFA1CB8 
7FFA1CCO 
7FFA1CC8 
7FFA1CDO 
7FFA1CD8 
7FFA1CE0 
7FFA1CE8 
7FFAICFO 
7FFAICF8 
7FFA1D00 
7FFA1D08 
7FFA1D10 
7FFA1D18 
7FFA1D20 
7FFA1D28 
7FFA1D30 
7FFA1D38 
7FFA1D40 
7FFA1D48 
7FFA1D50 
7FFA1D58 
7FFA1D60 
7FFA1D68 
7FFA1D70 
7FFA1D78 
7FFA1D80 
7FFA1D88 


18000000. 
00000000. 
00000000. 
00000000. 
00000000. 
FFFFFFFF. 
FFFFFFFF. 
00000000. 
00000000. 
FFFFFFFF 
00000000. 
FFFFFFFF. 
00000000. 
FFFFFFFF. 
00000000. 
FFFFFFFF 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000005. 
829CE050. 
00000000. 
00000000. 
FFFFFFFF. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 


00000000 
7FFA1CA0 
00000000 
7FFA1D40 
00000000 
829CF010 
82A2059C 
00000000 
7FFA1CDO 


- 829CEDA8 


00000000 
829CEDA8 
00000000 
82A1E930 
7FFA1F40 


- 80063780 


7FFALEB8 
7FFA1D40 
7FFA1F00 
TFFA1F40 
00000000 
00000000 
00020000 
00000250 
000008F8 
0000002C 
7AFFBADO 
FFFFFFFD 
00000000 
7FFA1F00 
7FFALEB8 
00020000 
00000000 
00020004 
00010050 


0000000F 


FFFFFFFF .80D0E000 
00000000.00000000 
00000000.00000000 


EXESEXCPTN 

EXCEPTION MON_PRO+0259C 
EXES$SET_PAGES READ ONLY+00948 
EXESSET_PAGES READ ONLY+00948 
EXESCONTSIGNAL C+001D0 


EXESACVIOLAT 


SYS$K_VERSION_04 
BUGS_NETRCVPKT 
BUG$_SEQ_NUM_OVF 


SYS$K_VERSION_04 
UCB$M_LCL_VALID+00004 
SYS$K_VERSION_16+00010 
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CHF$IH_MCH_SAVR18 00000000.7FFA1D90 = FFFFFFFF.FFFFFFFF 

CHF$IH_MCH SAVR19 00000000.7FFA1D98  00000000.00000000 

CHF$IH_MCH SAVR20 00000000.7FFAIDA0 00000000.7FFAI1F50 

CHF$IH_MCH SAVR21 00000000.7FFAIDA8  00000000.00000000 

CHF$IH_MCH_SAVR22 00000000.7FFAIDBO 00000000.00010050 SYS$K_VERSION_16+00010 
CHF$IH_MCH SAVR23 00000000.7FFAIDB8  00000000.00000000 

CHF$IH_MCH SAVR24 00000000.7FFAIDCO = 00000000.00010051 SYS$K_VERSION 16+00011 
CHF$IH_MCH SAVR25 00000000.7FFAIDC8  00000000.00000000 

CHF$IH_MCH SAVR26 00000000.7FFAIDD0 FFFFFFFF.8010ACA4 AMACSEMUL CALL NATIVE _C+000A4 
CHF$IH_MCH SAVR27 00000000.7FFAIDD8 = 00000000.00010050 SYS$K_VERSION_16+00010 
CHF$IH_MCH SAVR28 00000000.7FFAIDEO 00000000.00000000 


00000000. 7FFAI1DE8 00000000.00000000 
00000000. 7FFAIDFO 00000000.00000000 
00000000. 7FFAIDF8 00000000.00000000 
00000000. 7FFA1E00 00000000.00000000 
00000000. 7FFA1E08 00000000.00000000 
00000000. 7FFA1E10 00000000.00000000 
00000000. 7FFA1E18 00000000.00000000 
00000000. 7FFA1E20 00000000.00000000 
00000000. 7FFA1E28 00000000.00000000 
00000000. 7FFA1E30 00000000.00000000 
00000000. 7FFA1E38 00000000.00000000 
00000000. 7FFA1E40 00000000.00000000 
00000000. 7FFA1E48 00000000.00000000 
00000000. 7FFA1E50 00000000.00000000 
00000000. 7FFA1E58 00000000.00000000 
00000000. 7FFA1E60 00000000.00000000 
00000000. 7FFA1E68 00000000.00000000 
00000000. 7FFA1E70 00000000.00000000 
00000000. 7FFA1E78 00000000.00000000 
00000000. 7FFA1E80 00000000.00000000 
00000000. 7FFA1E88 00000000.00000000 
00000000. 7FFA1E90 00000000.00000000 
00000000. 7FFA1E98 00000000.00000000 
CHFSPH MCH SIG64 ADDR 00000000.7FFA1EA0 00000000. 7FFA1EDO 
~ ~ 00000000. 7FFA1EA8 00000000.00000000 
00000000. 7FFA1EBO 00000000. 7FFA1F50 
00000000. 7FFA1EB8 0000000C.00000005 
00000000. 7FFA1ECO 00000000.00010000 SYSS$K VERSION 07 
00000000. 7FFA1EC8 00000003.00030078 SYS$K VERSION _01+00078 
CHFSL SIG ARGS 00000000. 7FFA1EDO 00002604.00000005 UCBSM TEMPLATE+00604 
CHF$L_ SIG ARG1 00000000. 7FFA1ED8 00000000.0000000C ~ 
00000000. 7FFA1EE0 00000000.00010000 SYSS$K VERSION 07 
00000000. 7FFA1EE8 00000000.00000000 i. ~ 
00000000. 7FFA1EFO 00000000.00030078 SYSS$K VERSION 01+00078 
00000000. 7FFAI1EF8 00000000.00000003 ~ ~ 


INTSTKSQ R2 00000000. 7FFA1F00 00000000.00000003 

INTSTKSQ R3 00000000. 7FFA1F08 FFFFFFFF.80C63460 EXCEPTION MON NPRW+06A60 
INTSTKSO R4 00000000. 7FFA1F10 FFFFFFFF.80D12740 PCB >! 
INTSTK$Q_R5 00000000. 7FFA1F18 00000000.000000C8 

INTSTKSQ R6 00000000. 7FFA1F20 00000000.00030038 SYSSK VERSION 01+00038 
INTSTKS$Q_R7 00000000.7FFA1F28 00000000. 7FFA1FCO 7 . 

INTSTKSQ PC 00000000. 7FFA1F30 00000000.00030078 SYSSK VERSION 01+00078 
INTSTKSQ PS 00000000. 7FFA1F38 00000000.00000003 ~ ~ 


Prev SP (7FFA1F40) ==> 00000000.7FFA1F40  00000000.00010050 SYS$K_VERSION 16+00010 
00000000.7FFA1F48  00000000.00010000 SYS$K VERSION 07 
00000000.7FFAIF50  #FFFFFFFF.8010ACA4 AMACSEMUL_CALL NATIVE _C+000A4 
00000000.7FFAIF58 00000000. 7FFA1F70 
00000000.7FFA1F60  00000000.00000001 
00000000.7FFAIF68 § FFFFFFFF.800EE81C RM STDSDIRCACHE BLKAST_C+005AC 
00000000.7FFAIF70 § FFFFFFFF.80C6EBAO SCHS$CHSEP+001E0 - 
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00000000. 7FFA1F78 00000000.829CEDE8 EXESSIGTORET 

00000000. 7FFA1F80 00010050.00000002 SYSSK VERSION 16+00010 
00000000. 7FFA1F88 00000000.00020000 SYS$K VERSION 04 
00000000. 7FFA1F90 00000000.00030000 SYSSK VERSION 01 
00000000. 7FFA1F98 FFFFFFFF.800A4D64 EXCEPTION MON NPRO+00D64 
00000000. 7FFA1FA0 00000000.00000003 = 

00000000. 7FFALFA8 FFFFFFFF.80D12740 PCB 

00000000. 7FFA1FBO 00000000.00010000 SYSS$K VERSION 07 
00000000. 7FFA1FB8 00000000. 7AFFBADO - ~ 

00000000. 7FFA1FCO 00000000.7FFCF880 MMGSIMGHDRBUF+00080 
00000000. 7FFALFC8 00000000. 7B0E9851 

00000000. 7FFALFDO 00000000.7FFCF818 MMGSIMGHDRBUF+00018 
00000000. 7FFA1FD8 00000000.7FFCF938 MMGSIMGHDRBUF+00138 
00000000. 7FFA1FE0 00000000. 7FFAC9FO 

00000000. 7FFALFE8 00000000. 7FFAC9FO 

00000000. 7FFALFF0 FFFFFFFF.80000140 SYSSPUBLIC VECTORS NPRO+00140 
00000000. 7FFALFF8 00000000.0000001B - - 


2.7.2.8 Illegal Page Faults 


When an illegal page fault occurs, the stack appears as pictured in Figure 2-8. 


Figure 2-8 Stack Following an Illegal Page-Fault Error 


MMGS$PAGEFAULT Stack Frame 


iC Previous Stack Content ~ 


ZK-6787A-GE 


The stack contents are as follows: 


MMG$PAGEFAULT Stack Stack frame built at entry to MMG$PAGEFAULT, the 

Frame page fault exception service routine. On Alpha, the 
frame includes the contents of the following registers 
at the time of the page fault: R3, R8, R11 to R15, R29 
(frame pointer) 


SCH$PAGEFAULT Saved Contents of the following registers at the time of the 
Scratch Registers (Alpha only) page fault: RO, R1, R16 to R28 
Exception Stack Frame Exception stack frame —see Figure 2—5, Figure 2-6 


and Figure 2-7 


Previous Stack Content Contents of the stack prior to the illegal page-fault 
error 
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When you analyze a dump caused by a PGFIPLHI bugcheck, the SHOW STACK 
command identifies the exception stack frame using the symbols shown in 
Table 2-10 or Table 2-11. The SHOW CRASH or CLUE CRASH command 
displays the instruction that caused the page fault and the instructions around it. 


2.8 Page Protections and Access Rights 


Page protections and access rights are different on Alpha and 164 systems. They 
are visible in output from the following commands: 


SHOW PAGE 

SHOW PROCESS/PAGE 
EXAMINE/PTE 
EVALUATE/PTE 


Due to system differences, there is a need to distinguish “Write+Read+Execute” 
from “Write+Read” and to distinguish “Read+Execute” from “Read”. 


On an Alpha system, W=W+R+E and R=R+E but on an JA64 system, additional 
w and r indicators are introduced for non-execute cases. 


On Alpha, page protection is described by 8 bits— one Read bit for each mode, 
and one Write Bit. Therefore in the “Read” column, there might be KESU (read 
access in all modes) or K--- (read access in Kernel mode only) or NONE (no read 
access). Similarly in the “Writ” column. Not all combinations of the 8 bits are 
possible (for example, Write access for a mode implies Read access at that mode 
and both Read and Write access for all inner modes). 


On 164, page protection is described by 5 bits, a combination of the Access Rights 
and Privilege Level fields. SDA interprets these with a single character to 
describe access in each mode, as follows: 


Table 2-12 164 Access Codes for Page Protections 


Code Meaning 


Read 

Read, Write 

Read, Execute 

Read, Write, Execute 


K 


Execute 
Promote to Kernel 


Promote to Executive 


Amn MM aw Z 


Promote to Supervisor 


No access 


For example WRRR means Kernel mode has Read+Write+Execute access; all other 
modes have Read+Execute access. 
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2.9 Inducing a System Failure 


If the operating system is not performing well and you want to create a dump 
you can examine, you must induce a system failure. Occasionally, a device driver 
or other user-written, kernel-mode code can cause the system to execute a loop of 
code at a high priority, interfering with normal system operation. This loop can 
occur even though you have set a breakpoint in the code if the loop is encountered 
before the breakpoint. To gain control of the system in such circumstances, you 
must cause the system to fail and then reboot it. 


If the system has suspended all noticeable activity and is hung, see the examples 
of causing system failures in Section 2.9.2. 


If you are generating a system failure in response to a system hang, be sure to 
record the PC and PS as well as the contents of the integer registers at the time 
of the system halt. 


2.9.1 Meeting Crash Dump Requirements 


The following requirements must be met before the operating system can write a 
complete crash dump: 


e You must not halt the system until the console dump messages have been 
printed in their entirety and the memory contents have been written to the 
crash dump file. Be sure to allow sufficient time for these events to take place 
or make sure that all disk activity has stopped before using the console to 
halt the system. 


e There must be a crash dump file in SYS$SPECIFIC:[SYSEXE]: named either 
SYSDUMP.DMP or PAGEFILE.SYS. 


This dump file must be either large enough to hold the entire contents of 
memory (as discussed in Section 2.2.1.1) or, if the DUMPSTYLE system 
parameter is set, large enough to accommodate a subset or compressed dump 
(also discussed in Section 2.2.1.1). 


If SYSDUMP.DMP is not present, the operating system attempts to write 
crash dumps to PAGEFILE.SYS. In this case, the SAVEDUMP system 
parameter must be 1 (the default is 0). 


e Alternatively, the system must be set up for DOSD. See Section 2.2.1.5, and 
the HP OpenVMS System Manager’s Manual, Volume 2: Tuning, Monitoring, 
and Complex Systems for details. 


e The DUMPBUG system parameter must be 1 (the default is 1). 


2.9.2 Procedure for Causing a System Failure 
This section tells you how to enter the XDelta utility (XDELTA) to force a system 
failure. 


Before you can use XDelta, it must be loaded at system startup. To load XDelta 
during system bootstrap, you must set bit 1 in the boot flags. See the HP 
OpenVMS Version 8.2 Upgrade and Installation Manual for information about 
booting with the XDelta utility. 


On Alpha, put the system in console mode by pressing Ctrl/P or the Halt push 
button. Enter the following commands at the console prompt to enter XDelta: 


>>> DEPOSIT SIRR E 
>>> CONTINUE 


On 164, enter XDELTA by pressing Ctrl/P at the console. 
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Once you have entered XDelta, use any valid XDelta commands to examine 
register or memory locations, step through code, or force a system failure (by 
entering ;C under XDelta). See the HP OpenVMS Delta/XDelta Debugger 
Manual for more information about using XDelta. 


On Alpha, if you did not load XDelta, you can force a system crash by entering 
console commands that make the system incur an exception at high IPL. At the 
console prompt, enter commands to set the program counter (PC) to an invalid 
address and the PS to kernel mode at IPL 31 before continuing. This results in 
a forced INVEXCEPTN-type bugcheck. Some HP Alpha computers employ the 
console command CRASH (which will force a system failure) while other systems 
require that you manually enter the commands. 


Enter the following commands at the console prompt to force a system failure: 


>>> DEPOSIT PC FFFFFFFFFFFFFF00 
>>> DEPOSIT PS 1F00 
>>> CONTINUE 


For more information, refer to the hardware manuals that accompanied your 
Alpha computer. 


On 164, pressing Ctrl/P when XDelta is not loaded causes the OpenVMS system 
to output the following: 


Crash (y/n): 


A response of Y forces a system crash; entering any other character lets the 
system continue processing. 
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This chapter describes the format, usage, and qualifiers of the System Dump 
Analyzer (SDA) utility. 


The System Dump Analyzer (SDA) utility helps determine the causes of system 
failures. This utility is also useful for examining the running system. 


3.1 ANALYZE Qualifiers 


The following qualifiers described in this section determine whether the object of 
an SDA session is a crash dump or a running system. They also help create the 
environment of an SDA session. 


/CRASH_DUMP 
/OVERRIDE 
/RELEASE 
/SHADOW_MEMBER 
/SSLOG 

/SYMBOL 

/SYSTEM 


ANALYZE Usage 3-1 


ANALYZE Usage 


ANALYZE 
ANALYZE 
Format 
ANALYZE {/CRASH_DUMP 
[/OVERRIDE] 
[/RELEASE] 
[/SHADOW_MEMBER [= device-name]] 
filespec|/SYSTEM |/SSLOG} 
[/SYMBOL = system-symbols-table] 
Parameters 
device-name 
The device containing or to contain the system dump. 
filespec 
Name of the file that contains the dump you want to analyze. At least one 
field of the filespec is required, and it can be any field. The default filespec 
is the highest version of SYSDUMP.DMP in your default directory. The 
filespec is required for ANALYZE/CRASH_DUMP, but cannot be specified 
for ANALYZE/SYSTEM. 
system-symbol-table 
The system symbol table used by SDA. 
Description 


By default, the System Dump Analyzer is automatically invoked when you reboot 
the system after a system failure. 


To analyze a system dump interactively, invoke SDA by issuing the following 
command: 


$ ANALYZE/CRASH_DUMP filespec 
If you do not specify filespec, SDA prompts you for it. 


To analyze a crash dump, your process must have the privileges necessary for 
reading the dump file. This usually requires system privilege (SYSPRV), but 
your system manager can, if necessary, allow less privileged processes to read 
the dump files. Your process needs change-mode-to-kernel (CMKRNL) privilege 
to release page file dump blocks, whether you use the /RELEASE qualifier or the 
SDA COPY command. 


Invoke SDA to analyze a running system by issuing the following command: 
SANALYZE/SYSTEM 


To examine a running system, your process must have change-mode-to-kernel 
(CMKRNL) privilege. Your process must also have the map-by-PFN privilege 
(PFNMAP) to access memory by physical address on a running system. You 
cannot specify filespec when using the /SYSTEM qualifier. 


To send all output from SDA to a file, use the SDA command SET OUTPUT, 
specifying the name of the output file. The file produced is 132 columns wide and 
is formatted for output to a printer. To later redirect the output to your terminal, 
use the following command: 
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SDA> SET OUTPUT SYSSOUTPUT 


To send a copy of all the commands you type and a copy of all the output those 
commands produce to a file, use the SDA command SET LOG, specifying the 
name of the log file. The file produced is 1382 columns wide and is formatted for 
output to a printer. 


To exit from SDA, use the EXIT command. Note that the EXIT command also 
causes SDA to exit from display mode. Thus, if SDA is in display mode, you must 
use the EXIT command twice: once to exit from display mode, and a second time 
to exit from SDA. See Section 2.6.2 for a description of display mode. 


ANALYZE Usage 3-3 


ANALYZE Usage 
/CRASH_DUMP 


/CRASH_DUMP 


Invokes SDA to analyze the specified dump file. 


Format 
/CRASH_DUMP _ filespec 


Parameter 


filespec 
Name of the crash dump file to be analyzed. The default file specification is: 


SYS$DISK:[default-dir]JSYSDUMP.DMP 
SYS$DISK and [default-dir] represent the disk and directory specified in your 
last SET DEFAULT command. If you do not specify filespec, SDA prompts you 
for it. 
Description 


See Chapter 2, Section 2.3 for additional information on crash dump analysis. 
You cannot specify the /SYSTEM qualifier when you include the /CRASH_DUMP 
qualifier in the ANALYZE command. 


Examples 


1. § ANALYZE/CRASH_DUMP SYSSSYSTEM: SYSDUMP . DMP 
$ ANALYZE/CRASH SYSSSYSTEM 


These commands invoke SDA to analyze the crash dump stored in 
SYS$SYSTEM:SYSDUMP.DMP. 


2. $ ANALYZE/CRASH SYSSSYSTEM:PAGEFILE.SYS 


This command invokes SDA to analyze a crash dump stored in the system 
page file. 
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/OVERRIDE 


/OVERRIDE 


Format 


Parameter 


Description 


Example 


When used with the /CRASH_DUMP qualifier, invokes SDA to analyze only the 
structure of the specified dump file when a corruption or other problem prevents 
normal invocation of SDA with the ANALYZE/CRASH_DUMP command. 


/CRASH_DUMP/OVERRIDE _filespec 


filespec 
Name of the crash dump file to be analyzed. The default file specification is: 


SYS$DISK:|[default-dir]JSYSDUMP.DMP 


SYS$DISK and [default-dir] represent the disk and directory specified in your 
last SET DEFAULT command. If you do not specify filespec, SDA prompts you 
for it. 


See Chapter 2, Section 2.3 for additional information on crash dump analysis. 
Note that when SDA is invoked with /OVERRIDE, not all the commands in 
Chapter 2, Section 2.3 can be used. Commands that can be used are as follows: 


e Output control commands such as SET OUTPUT and SET LOG 
e Dump file related commands such as SHOW DUMP and CLUE ERRLOG 
Commands that cannot be used are as follows: 


e Commands that access memory addresses within the dump file such as 
EXAMINE and SHOW SUMMARY 


Also, the (RELEASE qualifier cannot be used when you include the /OVERRIDE 
qualifier in the ANALYZE/CRASH_DUMP command 


When /OVERRIDE is used, the SDA command prompt is SDA>>. 


$ ANALYZE/CRASH DUMP/OVERRIDE SYSSSYSTEM:SYSDUMP . DMP 
$ ANALYZE/CRASH/OVERRIDE SYSS$SSYSTEM 


These commands invoke SDA to analyze the crash dump stored in 
SYS$SYSTEM:SYSDUMP.DMP. 


ANALYZE Usage 3-5 


ANALYZE Usage 


/RELEASE 


/RELEASE 


Format 


Parameter 


Description 


Example 


Invokes SDA to release those blocks in the specified system page file occupied by 
a crash dump. 


Requires CMKRNL (change-mode-to-kernel) privilege. 


/CRASH_DUMP/RELEASE _filespec 


filespec 

Name of the system page file (SYS$SYSTEM:PAGEFILE.SYS). Because the 
default file specification is SYS$DISK:[default-dir|SYSDUMP.DMP, you must 
identify the page file explicitly. SYS$DISK and [default-dir] represent the disk 
and directory specified in your last DCL command SET DEFAULT. If you do not 
specify filespec, SDA prompts you for it. 


Use the /RELEASE qualifier to release from the system page file those blocks 
occupied by a crash dump. When invoked with the /RELEASE qualifier, SDA 
immediately deletes the dump from the page file and allows no opportunity to 
analyze its contents. 


When you specify the /RELEASE qualifier in the ANALYZE command, do the 
following: 


1. Use the /CRASH_DUMP qualifier. 


2. Include the name of the system page file (SYS$SYSTEM:PAGEFILE.SYS) as 
the filespec. 


If you do not specify the system page file or the specified page file does not 
contain a dump, SDA generates the following messages: 


%$SDA-E-BLKSNRLSD, no dump blocks in page file to release, or not page file 
$SDA-E-NOTPAGFIL, specified file is not the page file 


You cannot specify the /OVERRIDE or /SHADOW_MEMBER qualifier when you 
include the /RELEASE qualifier in the ANALYZE/CRASH_DUMP command. 


$ ANALYZE/CRASH DUMP/RELEASE SYSSSYSTEM:PAGEFILE.SYS 
$ ANALYZE/CRASH/RELEASE PAGEFILE.SYS 


These commands invoke SDA to release to the page file those blocks in 
SYS$SYSTEM:PAGEFILE.SYS occupied by a crash dump. 
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/SHADOW_MEMBER 


Format 


Description 


Specifies which member of a shadow set contains the system dump to be analyzed, 
or allows the user to determine what system dumps have been written to the 
members of the shadow set. 


/CRASH_DUMP/SHADOW_MEMBER __[=device-name] 


If the system disk is a shadow set, a system dump will only be written to one 
member of the shadow set (usually the master member at the time the dump is 
written). By default, if the filespec translates to a file on a shadow set, SDA will 
read the dump only from the master member. If at analysis time, the master 
member is different from where the dump was written, the /SHADOW_MEMBER 
qualifier allows the user to choose the member from which the dump is to be 
read. 


If the correct member is not known, the /SHADOW_MEMBER qualifier may 

be specified without a device name. SDA will display a one-line summary of the 
most recent dump written to each member and then prompt the user to determine 
which member to use. The prompt is: 


Shadow set action? 


The possible responses are: 


Command Effect 
EXIT Aborts the SDA session without analyzing a dump 
HELP Displays simple help text. See Example 3 below. 


USE <device_name> Initiates analysis of the system dump located on the 
specified shadow set member. 


The one-line summary for each member consists of the following fields: 


Member device name 

Bugcheck name 

Date and time of system crash 

Node name 

VMS Version 

Flags—none, one or more of: Bad_Checksum, ErrorLog_ Dump, Not_Saved, 
Old_Dump 


If there is no usable dump on a member, SDA output will an explanatory warning 
message followed by a line giving the member device name and the message "No 
system or error log dump found." 


Note that SDA cannot distinguish a dump on a shadowed system disk from a 
dump copied to a shadowed data disk. SDA will therefore always read the dump 
from a single member of a host-based shadow set. (In an OpenVMS Cluster 
system with multiple shadowed system disks, one system’s system disk will be a 
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data disk on other systems.) This does not affect dumps being read directly from 
a DOSD disk, since DOSD disks cannot be members of a host-based shadow set. 


Note 


The /SHADOW_MEMBER qualifier is not useful if the system dump has 
been written to the primary page file on a shadowed system disk. You 
cannot specify /RELEASE with /SHADOW_MEMBER. 


Examples 


1; 


$ ANALYZE/CRASH_DUMP DSA777: [SYSO0.SYSEXE ]SYSDUMP . DMP 
$SDA-I-USEMASTER, accessing dump file via _$31SDKB200:, master member of shadow set DSA777: 


OpenVMS (TM) Alpha system dump analyzer 
...analyzing a compressed selective memory dump... 


Dump taken on 12-DEC-2001 08:23:07.80 
SSRVEXCEPT, Unexpected system service exception 


SDA> 


This command initiates dump analysis using the master member of the shadow 
set DSA777 (the default action). 


$ ANALYZE/CRASH_DUMP/SHADOW_MEMBER=DKB0 DSA777: [SYS0.SYSEXE ] SYSDUMP .. DMP 
OpenVMS (TM) Alpha system dump analyzer 


...analyzing a compressed selective memory dump... 


Dump taken on 12-DEC-2001 08:23:07.80 
SSRVEXCEPT, Unexpected system service exception 


SDA> 


This command initiates dump analysis using member device $31$DKBO of the 
shadow set DSA777. 


$ ANALYZE/CRASH_DUMP/SHADOW MEMBER DSA8888: [SYS1.SYSEXE]SYSDUMP.DMP 


_$70$DKA303: INVEXCEPTN 16-NOV-2001 00:00:25.74 MRVP2 X96S-FT1 
_$70$DKA202: INCONSTATE 18-NOV-2001 02:08:45.05 MRVP2 X96S-FT1 


Shadow set action? HELP 


Shadow set actions: 


EXIT exit SDA 
HELP this display 
USE <shadow_set_member> proceed using specified shadow set member 


Shadow set action? USE _$70$DKA303: 


OpenVMS (TM) Alpha system dump analyzer 
...analyzing a compressed selective memory dump... 


%SDA-W-NOTSAVED, global pages not saved in the dump file 
Dump taken on 16-NOV-2001 00:00:25.74 
INVEXCEPTN, Exception while above ASTDEL 


SDA> EXIT 


This command displays the dumps to be found on the members of shadow set 
DSA8888:[SYS1.SYSEXE]SYSDUMP.DMP and then begins analysis of the dump 
written to device _$70$DKA303. 
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/SSLOG 
/SSLOG 
Displays data collected by the System Service Logging Utility (SSLOG). For more 
information about this and associated commands, see Chapter 14, System Service 
Logging. 
Format 
/SSLOG 


ANALYZE Usage 3-9 


ANALYZE Usage 


/SYMBOL 


/SYMBOL 


Format 


Description 


Example 


Specifies an alternate system symbol table for SDA to use. 


/SYMBOL = system-symbol-table 


File specification of the OpenVMS Alpha SDA system symbol table required 
by SDA to analyze a system dump or running system. The specified system- 
symbol-table must contain those symbols required by SDA to find certain 
locations in the executive image. 


If you do not specify the /SYMBOL qualifier, SDA uses SDA$READ_ 
DIR:SYS$BASE_IMAGE.EXE to load system symbols into the SDA symbol 
table. When you specify the /SYMBOL qualifier, SDA assumes the default disk 
and directory to be SYS$DISK:[ ], that is, the disk and directory specified in your 
last DCL command SET DEFAULT. If you specify a file for this parameter that is 
not a system symbol table, SDA exits with a fatal error. 


The /SYMBOL qualifier allows you to specify a system symbol table to load into 
the SDA symbol table. You can use the /SYMBOL qualifier whether you are 
analyzing a system dump or a running system. It is not normally necessary 

to use the /SYMBOL qualifier when analyzing the running system, since the 
default SYS$BASE_IMAGE.EXE is the one in use in the system. However 

if SDA$READ_DIR has been redefined during crash dump analysis, then the 
/SYMBOL qualifier can be used to ensure that the correct base image is found 
when analyzing the running system. 


The /SYMBOL qualifier can be used with the /CRASH_DUMP and /SYSTEM 
qualifiers. It is ignored when /OVERRIDE or /RELEASE is specified. 


$ ANALYZE/CRASH_DUMP/SYMBOL=SDASREAD DIR :SYS$BASE IMAGE.EXE SYSS$SYSTEM 


This command invokes SDA to analyze the crash dump stored in 
SYS$SYSTEM:SYSDUMP.DMP, using the base image in SDA$READ_DIR. 
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/SYSTEM 


ISYSTEM 


Format 


Parameters 


Description 


Example 


Invokes SDA to analyze a running system. 


Requires CMKRNL (change-mode-to-kernel) privilege. Also requires PFNMAP 
(map-by-PFN) privilege to access memory by physical address. 


/SYSTEM 


None. 


See Chapter 2, Section 2.4 for information on how to use SDA to analyze a 
running system. See Chapter 4 for information on SDA commands. 


You cannot specify the /CRASH_DUMP, /OVERRIDE, /RELEASE, or /SHADOW_ 
MEMBER qualifiers when you include the /SYSTEM qualifier in the ANALYZE 
command. 


$ ANALYZE/SYSTEM 
OpenVMS (TM) system analyzer 


SDA> 


This command invokes SDA to analyze the running system. 


ANALYZE Usage 3-11 


4 


SDA Commands 


This chapter describes the SDA commands that you can use to analyze a 
system dump or a running system. SDA CLUE extension commands, which 
can summarize information provided by certain SDA commands and provide 
additional detail for some SDA commands, are described in the chapter on SDA 
CLUE Commands. 


The SDA commands are as follows: 


@ (Execute Command) 
ATTACH 

COPY 

DEFINE 
DEFINE/KEY 

DUMP 

EVALUATE 
EXAMINE 

EXIT 

FLT 

FORMAT 

HELP 

MAP 

MODIFY DUMP 
READ 

REPEAT 

SEARCH 

SET CPU 

SET ERASE_SCREEN 
SET FETCH 

SET LOG 

SET OUTPUT 

SET PROCESS 

SET RMS 

SET SIGN_EXTEND 
SET SYMBOLIZE 
SHOW ADDRESS 
SHOW BUGCHECK 
SHOW CALL_ FRAME 
SHOW CBB 

SHOW CEB 

SHOW CLUSTER 
SHOW CONNECTIONS 
SHOW CPU 

SHOW CRASH 
SHOW DEVICE 
SHOW DUMP 
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SHOW EXCEPTION_FRAME 
SHOW EXECUTIVE 
SHOW GALAXY 
SHOW GCT 

SHOW GLOBAL_SECTION_TABLE, SHOW GST 
SHOW GLOCK 
SHOW GMDB 

SHOW GSD 

SHOW HEADER 
SHOW IMAGE 

SHOW KFE 

SHOW LAN 

SHOW LOCKS 

SHOW MACHINE_CHECK 
SHOW MEMORY 
SHOW PAGE_TABLE 
SHOW PARAMETER 
SHOW PFN_DATA 
SHOW POOL 

SHOW PORTS 

SHOW PROCESS 
SHOW RAD 

SHOW RESOURCES 
SHOW RMD 

SHOW RMS 

SHOW RSPID 

SHOW SHM_CPP 
SHOW SHM_REG 
SHOW SPINLOCKS 
SHOW STACK 
SHOW SUMMARY 
SHOW SWIS 

SHOW SYMBOL 
SHOW TQE 

SHOW TQEIDX 
SHOW UNWIND 
SHOW WORKING. SET_LIST, SHOW WSL 
SPAWN 

UNDEFINE 
VALIDATE PFN_LIST 
VALIDATE QUEUE 
VALIDATE SHM_CPP 
VALIDATE TQEIDX 
WAIT 
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@(Execute Command) 


Format 


Parameter 


Example 


Causes SDA to execute SDA commands contained in a file. Use this command to 
execute a set of frequently used SDA commands. 


@filespec 


filespec 
Name of a file that contains the SDA commands to be executed. The default file 
type is .COM. 


SDA> @USUAL 


The execute (@) command executes the following commands, as contained in a file 
named USUAL.COM: 


SET OUTPUT LASTCRASH.LIS 
SHOW CRASH 

SHOW PROCESS 

SHOW STACK 

SHOW SUMMARY 


This command procedure first makes the file LASTCRASH.LIS the destination for 
output generated by subsequent SDA commands. Next, the command procedure 
sends information to the file about the system failure and its context, including 

a description of the process executing at the time of the failure, the contents of 
the stack on which the failure occurred, and a list of the processes active on the 
system. 


An EXIT command within a command procedure terminates the procedure at 
that point, as would an end-of-file. 


Command procedures cannot be nested. 
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ATTACH 
ATTACH 
Switches control of your terminal from your current process to another process in 
your job (for example, one created with the SDA SPAWN command). 
Format 
ATTACH [/PARENT] process-name 
Parameter 
process-name 
Name of the process to which you want to transfer control. 
Qualifier 
/PARENT 
Transfers control of the terminal to the parent process of the current process. 
When you specify this qualifier, you cannot specify the process-name parameter. 
Examples 


1. SDA> ATTACH/PARENT 


This ATTACH command attaches the terminal to the parent process of the 
current process. 


2. SDA> ATTACH DUMPER 


This ATTACH command attaches the terminal to a process named DUMPER 
in the same job as the current process. 
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COPY 


Format 


Parameter 


Qualifiers 


Description 


Copies the contents of the dump file to another file. 


COPY  [/qualifier...] output-filespec 


output-filespec 
Name of the device, directory, and file to which SDA copies the dump file. The 
default file specification is: 


SYS$DISK:[default-dir|filename.DMP 


SYS$DISK and [default-dir] represent the disk and directory specified in your 
last DCL command SET DEFAULT. You must specify a file name. 


/COMPRESS 

Causes SDA to compress dump data as it is writing a copy. If the dump being 
analyzed is already compressed, then SDA does a direct COPY, and issues an 
informational message indicating that it is ignoring the /COMPRESS qualifier. 


/DECOMPRESS 

Causes SDA to decompress dump data as it is writing a copy. If the dump being 
analyzed is already decompressed, then SDA does a direct COPY, and issues an 
informational message indicating that it is ignoring the /DECOMPRESS qualifier. 


Each time the system fails, the contents of memory and the hardware context of 
the current process (as directed by the DUMPSTYLE parameter) are copied into 
the file SYS$SYSTEM:SYSDUMP.DMP (or the page file), overwriting its contents. 
If you do not save this crash dump elsewhere, it will be overwritten the next time 
that the system fails. 


The COPY command allows you to preserve a crash dump by copying its contents 
to another file. It is generally useful to invoke SDA during system initialization 
to execute the COPY command. This ensures that a copy of the dump file is made 
only after the system has failed. The preferred method for doing this, using the 
logical name CLUE$SITE_PROC, is described in Section 2.2.3. 


The COPY command does not affect the contents of the file containing the dump 
being analyzed. 


If you are using the page file (SYS$SYSTEM:PAGEFILE.SYS) as the dump 
file instead of SYSDUMP.DMP, successful completion of the COPY command 
will automatically cause the blocks of the page file containing the dump to be 
released, thus making them available for paging. Even if the copy operation 
succeeds, the release operation requires that your process have change-mode- 
to-kernel (CMKRNL) privilege. When the dump pages have been released from 
the page file, the dump information in these pages will be lost and SDA will 
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COPY 
immediately exit. You must perform subsequent analysis upon the copy of the 
dump created by the COPY command. 
If you press Ctrl/T while using the COPY command, the system displays how 
much of the file has been copied. 

Example 


SDA> COPY SYSSCRASH:SAVEDUMP 


The COPY command copies the dump file into the file 
SYS$CRASH:SAVEDUMP.DMP. 
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DEFINE 


Format 


Parameters 


Qualifier 


Description 


Examples 


Assigns a value to a symbol. 


DEFINE  [/qualifier...] symbol-name [=] expression 


symbol-name 

Name, containing from 1 to 31 alphanumeric characters, that identifies the 
symbol. See Section 2.6.1.4 for a description of SDA symbol syntax and a list of 
default symbols. 


expression 
Definition of the symbol’s value. See Section 2.6.1 for a discussion of the 
components of SDA expressions. 


/FD 

/PD 

Defines a symbol as a function descriptor (FD) or procedure descriptor (PD). It 
also defines the routine address symbol corresponding to the defined symbol (the 
routine address symbol has the same name as the defined symbol, only with _C 
appended to the symbol name). See Section 2.6.1.4 for more information about 
symbols. /FD and /PD are completely interchangeable. SDA interprets them 
based on the architecture of the system or dump being analyzed. 


The DEFINE command causes SDA to evaluate an expression and then assign 
its value to a symbol. Both the DEFINE and EVALUATE commands perform 
computations to evaluate expressions. DEFINE adds symbols to the SDA symbol 
table but does not display the results of the computation. EVALUATE displays 
the result of the computation but does not add symbols to the SDA symbol table. 


1. SDA> DEFINE BEGIN = 80058E00 
SDA> DEFINE END = 80058E60 
SDA> EXAMINE BEGIN: END 


In this example, DEFINE defines two addresses, called BEGIN and END. 
These symbols serve as reference points in memory, defining a range of 
memory locations for the EXAMINE command to inspect. 


2. SDA> DEFINE NEXT = @PC 
SDA> EXAMINE/INSTRUCTION NEXT 
NEXT: HALT 


The symbol NEXT defines the address contained in the program counter, so 
that the symbol can be used in an EXAMINE/INSTRUCTION command. 
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SDA> DEFINE VEC SCH$GL PCBVEC 

SDA> EXAMINE VEC ~ 

SCHSGL PCBVEC: 00000000.8060F2CC "IO‘..... " 
SDA> 


After the value of global symbol SCH$GL_PCBVEC has been assigned to 
the symbol VEC, the symbol VEC is used to examine the memory location or 
value represented by the global symbol. 


SDA> DEFINE/PD VEC SCHSQAST 

SDA> EXAMINE VEC 

SCHSQAST: 0000002C.00003008 "Qepecen 
SDA> EXAMINE VEC_C 

SCHSQAST C: B75E0008.43C8153E "> EC. oem 
SDA> ~ 


In this example, the DEFINE/PD command defines not only the symbol VEC, 
but also the corresponding routine address symbol (VEC_C). 
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DEFINE/KEY 


Format 


Parameters 


Qualifiers 


Associates an SDA command with a terminal key. 


DEFINE/KEY  [/qualifier...] key-name command 


key-name 
Name of the key to be defined. You can define the following keys under SDA: 


Key Name Key Designation 
PF1 LK201, VT100 

PF2 LK201, VT100 

PF3 LK201, VT100 

PF4 LK201, VT100 
KPO ... KP9 Keypad 0-9 
PERIOD Keypad period 
COMMA Keypad comma 
MINUS Keypad minus 
ENTER Keypad ENTER 
UP Up arrow 

DOWN Down arrow 

LEFT Left arrow 

RIGHT Right arrow 

El LK201 Find 

E2 LK201 Insert Here 
E3 LK201 Remove 

E4 LK201 Select 

E5 LK201 Prev Screen 
E6 LK201 Next Screen 
HELP LK201 Help 

DO LK201 Do 

F7... F20 LK201 Function keys 
command 


SDA command to define a key. You must enclose the command in quotation 
marks (""). 


/IF_STATE=state_list 

/NOIF_STATE 

Specifies a list of one or more states, one of which must be in effect for the key 
definition to work. The /NOIF_STATE qualifier has the same meaning as /IF_ 
STATE=current_state. The state name is an alphanumeric string. States are 
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established with the /SET_STATE qualifier. If you specify only one state name, 
you can omit the parentheses. By including several state names, you can define a 
key to have the same function in all the specified states. 


/IKEY 

Defines a key as an SDA command. To issue the command, press the defined key 
and the Return key. If you use the /TERMINATE qualifier as well, you do not 
have to press the Return key. You must specify the /KEY qualifier. 


/LOCK_STATE 

/INOLOCK_STATE 

Specifies that the state set by the /SET_STATE qualifier remains in effect until 
explicitly changed. By default, the /SET_STATE qualifier is in effect only for the 
next definable key you press or the next read-terminating character that you 
type. You can specify this qualifier only with the /SET_STATE qualifier. 


The default is /NOLOCK_ STATE. 


/SET_STATE=state-name 

/NOSET_STATE 

Causes the key being defined to create a key state change instead of or in 
addition to issuing an SDA command. When you use the /SET_STATE qualifier, 
you supply the name of a key state to be used with the /IF_STATE qualifier in 
other key definitions. 


For example, you can define the PF1 key as the GOLD key and use the /IF_ 
STATE=GOLD qualifier to allow two definitions for the other keys, one in the 
GOLD state and one in the non-GOLD state. For more information on using the 
/IF_STATE qualifier, see the DEFINE/KEY command in the HP OpenVMS DCL 
Dictionary: A-M. 


The default is /NOSET_STATE. 


/TERMINATE 

/NOTERMINATE 

Causes the key definition to include termination of the command, which causes 
SDA to execute the command when the defined key is pressed. Therefore, you do 
not have to press the Return key after you press the defined key if you specify the 
/TERMINATE qualifier. 


Description 


The DEFINE/KEY command causes an SDA command to be associated with 
the specified key, in accordance with any of the specified qualifiers described 
previously. 


If the symbol or key is already defined, SDA replaces the old definition with the 
new one. Symbols and keys remain defined until you exit from SDA. 
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SDA> DEFINE/KEY PF1 "SHOW STACK" 
SDA>  [PFi] SHOW STACK [RETURN 
Process stacks (on CPU 00) 


Current operating stack (KERNEL): 


The DEFINE/KEY command defines PF1 as the SHOW STACK command. 
When you press the PF1 key, SDA displays the command and waits for you to 
press the Return key. 


SDA> DEFINE/KEY/TERMINATE PF1 "SHOW STACK" 
SDA>  |[PFi] SHOW STACK 
Process stacks (on CPU 00) 


Current operating stack (KERNEL): 
00000000.7FF95D00 00000000.0000000B 
00000000.7FF95D08 FFFFFFFF.804395C8 MMGS$TBI DATA 64+000B8 
00000000.7FF95D10 00000000.00000000 
00000000.7FF95D18 OQ000FE00.00007E04 

SP => 00000000.7FF95D20 00000000.00000800 IRPSM EXTEND 
00000000.7FF95D28 00000001.000002F7 UCB$B_PI_FKB+0000B 
00000000.7FF95D30 FFFFFFFF.804395C8 MMGS$TBI DATA 64+000B8 
00000000.7FF95D38 00000002.00000000 


The DEFINE/KEY command defines PF1 as the SDA SHOW STACK 
command. The /TERMINATE qualifier causes SDA to execute the SHOW 
STACK command without waiting for you to press the Return key. 


SDA> DEFINE/KEY/SET STATE="GREEN" PF1l "" 

SDA> DEFINE/KEY/TERMINATE/IF STATE=GREEN PF3 "SHOW STACK" 
SDA>  [PFi] [PF3] SHOW STACK ~ 

Process stacks (on CPU 00) 


Current operating stack (KERNEL): 


The first DEFINE/KEY command defines PF1 as a key that sets a command 
state GREEN. The trailing pair of quotation marks is required syntax, 
indicating that no command is to be executed when this key is pressed. 


The second DEFINE command defines PF3 as the SHOW STACK command, 
but using the /IF_STATE qualifier makes the definition valid only when the 
command state is GREEN. Thus, you must press PF1 before pressing PF3 to 
issue the SHOW STACK command. The /TERMINATE qualifier causes the 
command to execute as soon as you press the PF3 key. 
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DUMP 
DUMP 
Displays the contents of a range of memory formatted as a comma-separated 
variable (CSV) list, suitable for inclusion in a spreadsheet. 
Format 
DUMP _ range 
[/LONGWORD (default) | /QUADWORD] 
[/DECIMAL |/HEXADECIMAL (default)] 
[/FORWARD (default) | /REVERSE] 
[/RECORD_SIZE=size] (default = 512) 
[/INDEX_ARRAY [={ LONGWORD (default) |QUADWORD}] ] 
[(/INITIAL_POSITION={ ADDRESS=address | RECORD=numbe/] 
[/COUNT = {ALL | records}] (default = all records) 
[/PHYSICAL] 
Parameter 
range 
The range of locations to be displayed. The range is specified in one of the 
following formats: 
m:n Range from address m to address n inclusive 
m;n Range from address m for n bytes 
Qualifiers 


/COUNT=[{ ALL | records}] 
Gives the number of records to be displayed. The default is to display all records. 


/DECIMAL 
Outputs data as decimal values. 


/FORWARD 
Causes SDA to display the records in the history buffer in ascending address 
order. This is the default. 


/HEXADECIMAL 
Outputs data as hexadecimal values. This is the default. 


ANDEX_ARRAY [={ LONGWORD (default) | QUADWORD}}] 

Indicates to SDA that the range of addresses given is a vector of pointers to 
the records to be displayed. The vector can be a list of longwords (default) or 
quadwords. The size of the range must be an exact number of longwords or 
quadwords as appropriate. 


/INITIAL_POSITION = { ADDRESS=address | RECORD=number} 

Indicates to SDA which record is to be displayed first. The default is the lowest 
addressed record if /FORWARD is used, and the highest addressed record if 
/REVERSE is used. The initial position may be given as a record number within 
the range, or the address at which the record is located. 


/LONGWORD 
Outputs each data item as a longword. This is the default. 
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/PHYSICAL 
Indicates to SDA that all addresses (range and/or start position) are physical 
addresses. By default, virtual addresses are assumed. 


/QUADWORD 
Outputs each data item as a quadword. 


/RECORD_SIZE=size 

Indicates the size of each record within the history buffer, the default being 512 
bytes. This size must exactly divide into the total size of the address range to be 
displayed, unless /INDEX_ARRAY is specified. 


/REVERSE 
Causes SDA to display the records in the history buffer in descending address 
order. 


The DUMP command displays the contents of a range of memory formatted as a 

comma-separated variable (CSV) list, suitable for inclusion in a spreadsheet. It is 
intended for use with a history buffer containing records of information of which 

the most recently written entry is in the middle of the memory range. 


Note 
See SET OUTPUT/NOHEADER for related information. 


1. SDA> DUMP dump g;200/initial_position=record=5/record_size=20/reverse 
05,A77B0010,A79B0008,6B9C4001,47FF041F,A03E0000,47DF041C,201F0016,083 
04,A03E0000,47DF041C,201F0058,083,A77B0010,A79B0008,6B9C4001,47FF041F 
03,A03E0000,47DF041C,201F0075,083,A03E0000,47DF041C,201F001B,083 
02,A77B0010,A79B0008,6B9C4001,47FF041F,A03E0000,47DF041C,201F0074,083 
01,43E05120,083,6BFA8001,47FF041F,A77B0010,A79B0008,6B9C4001,47FF041F 
0,201F0104,6BFA8001,47FF041F,47FF041F,201F0001,6BFA8001,47FF041F,47FF041F 
OF ,A03E0000,47DF041C,201F0065,083,A03E0000,47DF041C,201F0006,083 
0E,A03E0000,47DF041C,201F001C,083,A03E0000,47DF041C,201F001A,083 
0D,A03E0000,47DF041C,201F0077,083,A03E0000,47DF041C,201F0057,083 
0C,A03E0000,47DF041C,201F002B,083,A03E0000,47DF041C,201F003A,083 
0B, A03E0000,47DF041C,201F007D,083,A77B0010,A79B0008,6B9C4001,47FF041F 
0A,A03E0000,47DF041C,201F005A,083,A03E0000,47DF041C,201F0078,083 
09,A03E0000,47DF041C,201F0002,082,A03E0000,47DF041C,201F0037,083 
08,A03E0000,47DF041C,201F0035,083,A03E0000,47DF041C,201F007A,083 
07,A03E0000,47DF041C,201F0019,083,A03E0000,47DF041C,201F0034,083 
06,A77B0010,A79B0008,6B9C4001,47FF041F,A03E0000,47DF041C,201F0018,083 


This example shows the dump of an area of memory treated as 16 records of 
32 bytes each, beginning at record 5, and dumped in reverse order. Note the 
record number in the first field, and that the dump wraps to the end of the 
memory area after the first record has been output. 
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2. SDA> EXAMINE SMPSGL CPU DATA; 80 
00000000 00000000 8FE26000 8FE14000 00000000 00000000 8FE02000 811FE000 
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 


SDA> DUMP SMP$GL_CPU_DATA;80/index_array/record_size=20/count=5 
0,810C17C0, 8EC7C180,026A09C0,02,0,FFFFFFFF,0,0 
01,810C17C0,8EC7C400,026A09C0,02,0,FFFFFFFF,0,01 
04,810C17C0,8EC7CB80,026A09C0,02,0,FFFFFFFF,0,04 


This example shows the contents of the CPU database vector, then dumps the 
first 32 bytes of each CPU database entry. Only the first five entries in the 
array are requested, and those containing zero are ignored. 
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EVALUATE 


Format 


Parameter 


Qualifiers 


Computes and displays the value of the specified expression in both hexadecimal 
and decimal. Alternative evaluations of the expression are available with the use 
of the qualifiers defined for this command. 


EVALUATE § [{/CONDITION_VALUE |/FPSRI/IFS 
IASRI/PFS|/PS|I/PSR 
|/PTE 
|/INO]JSYMBOLS |/TIME}] expression 


expression 
SDA expression to be evaluated. Section 2.6.1 describes the components of SDA 
expressions. 


/CONDITION_VALUE 
Displays the message that the $GETMSG system service obtains for the value of 
the expression. 


/FPSR 
(164 only.) Evaluates the specified expression in the format of a floating-point 
status register. 


NFS 
(164 only.) Evaluates the specified expression in the format of an interruption 
function state. 


ASR 
(164 only.) Evaluates the specified expression in the format of an interruption 
status register. 


IPFS 
(164 only.) Evaluates the specified expression in the format of a previous function 
state. 


IPS 
Evaluates the specified expression in the format of a processor status. 


/PSR 
(164 only.) Evaluates the specified expression in the format of a processor status 
register. 


/PTE 

Interprets and displays the expression as a page table entry (PTE). The individual 
fields of the PTE are separated and an overall description of the PTE’s type is 
provided. 
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/SYMBOLS 

/NOSYMBOLS 

Specifies that all symbols known to be equal to the evaluated expression are to 
be listed in alphabetical order. The default behavior of the EVALUATE command 
displays only the first five symbols. If /NOSYMBOLS is specified, only the 
hexadecimal and decimal values are displayed. 


/TIME 
Interprets and displays the expression as a 64-bit time value. Positive values are 
interpreted as absolute time; negative values are interpreted as delta time. 


Description 


If you do not specify a qualifier, the EVALUATE command interprets and displays 
the expression as hexadecimal and decimal values. In addition, if the expression 
is equal to the value of a symbol in the SDA symbol table, that symbol is 
displayed. If no symbol with this value is known, the next lower valued symbol 
is displayed with an appropriate offset unless the offset is extremely large. (See 
Section 2.6.1.4 for a description of how SDA displays symbols and offsets.) The 
DEFINE command adds symbols to the SDA symbol table but does not display 
the results of the computation. EVALUATE displays the result of the computation 
but does not add symbols to the SDA symbol table. 


Examples 


1. SDA> EVALUATE -1 
Hex = FFFFFFFF.FFFFFFFF Decimal = -1 I 


The EVALUATE command evaluates a numeric expression, displays the value of 
that expression in hexadecimal and decimal notation, and displays a symbol that 
has been defined to have an equivalent value. 


2. SDA> EVALUATE 1 
Hex = 00000000.00000001 Decimal = 1 CHFSM CALEXT CANCEL 
~ CHFSM FPREGS VALID 
CHF$V CALEXT LAST 
IRPSM BUFIO 
IRP$M_CLN READY 


(remaining symbols suppressed by default) 


The EVALUATE command evaluates a numeric expression and displays the 
value of that expression in hexadecimal and decimal notation. This example also 
shows the symbols that have the displayed value. A maximum of five symbols are 
displayed by default. 


3. SDA> DEFINE TEN = A 
SDA> EVALUATE TEN 
Hex = 00000000.0000000A Decimal = 10 IRPSB TYPE 
IRP$S FMOD 
IRPSV MBXIO 
TEN 
UCB$B_TYPE 


(remaining symbols suppressed by default) 


This example shows the definition of a symbol named TEN. The EVALUATE 
command then shows the value of the symbol. 
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Note that A, the value assigned to the symbol by the DEFINE command, could 
be a symbol. When SDA evaluates a string that can be either a symbol or a 
hexadecimal numeral, it first searches its symbol table for a definition of the 
symbol. If SDA finds no definition for the string, it evaluates the string as a 
hexadecimal number. 


SDA> EVALUATE (((TEN * 6) + (-1/4) 


) + 6) 
Hex = 00000000.00000042 Decimal = 


66 


This example shows how SDA evaluates an expression of several terms, including 
symbols and rational fractions. SDA evaluates the symbol, substitutes its value in 
the expression, and then evaluates the expression. The fraction -1/4 is truncated 
to 0. 


SDA> EVALUATE/CONDITION 80000018 
SSYSTEM-W-EXQUOTA, exceeded quota 


This example shows the output of an EVALUATE/CONDITION command. 


SDA> EVALUATE/PFS 00000000.000013AF 


PPL PEC RRB.PR RRB.FR RRB.GR SOR SOL SOF 

0 0. 0. 0. 0. 0. 39. (32-70) 47. (32-78) 
This example shows the output of an EVALUATE/PFS command on an [64 
system. 


SDA> EVALUATE/PS 0B03 
MBZ SPAL MBZ IPL VMM MBZ CURMOD INT PRVMOD 
0 00 00000000000 0B 0 0 KERN 0 USER 


In this EVALUATE/PS command on an Alpha system, SDA interprets the entered 
value 0B03 as though it were a processor status (PS) and displays the resulting 
field values. 


SDA> EVALUATE/PSR 00001410.0A026010 
RT TB LP DB SI DI PP SP DFH DFL DT PK I IC MFH MFL AC BE 
1 0 1 0 0 0 0 0 0 0 1 0 1 1 0 1 0 0 
IA BN ED RI SS DD DA ID IT MC IS CPL 
0 1 0 2 0 0 0 0 1 0 0 0 


This example shows the output of an EVALUATE/PSR command on an I64 
system. 


SDA> EVALUATE/PTE OBCDFFEE 


332 2 2 1 ta 
109 7 0 8 65 7 6 0 
+-+-+--+-------------- +-+-+---+-+--------------- +-+----------- +--+ 
|0|0|00| 005E |O|x| 02|1} FF x| 37 | 0| 
+-+-+--+-------------- +-+-+---+-+--------------- +-+----------- +--+ 

| 00000000 | 
ee at ee ee ee + 
Global PTE: Owner = S, Read Prot = KESU, Write Prot = KESU, CPY = 0 

GPT Index = 00000000 


The EVALUATE/PTE command displays the expression 0BCDFFEE as a page 
table entry (PTE) and labels the fields. It also describes the status of the page. 
For more information on interpreting information in this output, see Section 2.8. 
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10. SDA> EVALUATE/TIME 009A9A4C.843DBA9F 
10-OCT-1996 15:59:44.02 


This example shows the use of the EVALUATE/TIME command. 
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EXAMINE 


Format 


Parameter 


Qualifiers 


Displays either the contents of a location or of a range of locations in physical 
memory, or the contents of a register. Use location parameters to display specific 
locations or use qualifiers to display the entire process and system regions of 
memory. 


EXAMINE _ [/qualifier[,...]] [location] 


location 

Location in memory to be examined. A location can be represented by any valid 
SDA expression. (See Section 2.6.1 for additional information about expressions.) 
To examine a range of locations, use the following syntax: 


m:n Range of locations to be examined, from m to n 


m;n Range of locations to be examined, starting at m and continuing for n 
bytes 


The default location that SDA uses is initially 0 in the program region (PO) 

of the process that was executing at the time the system failed (if you are 
examining a crash dump) or your process (if you are examining the running 
system). Subsequent uses of the EXAMINE command with no parameter 
specified increase the last address examined by eight. Use of the INSTRUCTION 
qualifier increases the default address by four (Alpha) or 16 (164). To examine 
memory locations of other processes, you must use the SET PROCESS command. 


/ALL 

Examines all the locations in the program, and control regions and system 
space, displaying the contents of memory in hexadecimal longwords and ASCII 
characters. Do not specify parameters when you use this qualifier. 


/CONDITION_VALUE 
Examines the specified longword, displaying the message that the $GETMSG 
system service obtains for the value in the longword. 


/FD 
See the description of /PD. 


/FPSR 
(164 only.) Examines the specified expression in the format of a floating-point 
status register. 


NFS 
(164 only.) Examines the specified expression in the format of an interruption 
function state. 


[INSTRUCTION 

Translates the specified range of memory locations into assembly instruction 
format. Each symbol in the EXAMINE expression that is defined as a procedure 
descriptor is replaced with the code entry point address of that procedure, unless 
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you also specify the /NOPD qualifier. For 164 only, SDA always displays entire 
bundles of instructions, not individual slots. 


ASR 
(164 only.) Examines the specified expression in the format of an interruption 
status register. 


/NOFD 
See the description of /NOPD. 


/NOPD 

Can be used with the INSTRUCTION qualifier to override treating symbols as 
function or procedure descriptors. You can place the qualifier immediately after 
the INSTRUCTION qualifier, or following a symbol name. /NOFD and /NOPD 
are completely interchangeable. SDA interprets them based on the architecture 
of the system or dump being analyzed. 


For more details on using the /NOFD and /NOPD qualifiers, see the description 
for the /PD qualifier. 


/NOSUPPRESS 
Inhibits the suppression of zeros when displaying memory with one of the 
following qualifiers: /ALL, /PO, /P1, /SYSTEM, or when a range is specified. 


/PO 
Displays the entire program region for the default process. Do not specify 
parameters when you use this qualifier. 


/P1 
Displays the entire control region for the default process. Do not specify 
parameters when you use this qualifier. 


/PD 

Causes the EXAMINE command to treat the location specified in the EXAMINE 
command as a function descriptor (FD) or procedure descriptor (PD). /FD or /PD 
can also be used to qualify symbols. /FD and /PD are completely interchangeable. 
SDA interprets them based on the architecture of the system or dump being 
analyzed. For clarity, the remainder of this description refers only to /PD and 
/NOPD. 


You can use the /PD and /NOPD qualifiers with the /INSTRUCTION qualifier 
to override treating symbols as procedure descriptors. Placing the qualifier 
right after a symbol overrides how the symbol is treated. /PD forces it to be a 
procedure descriptor, and /NOPD forces it to not be a procedure descriptor. 


Only the /PD qualifier can be placed right after the /INSTRUCTION qualifier. 
SDA treats the calculated value as a function or procedure descriptor as 
appropriate. 


In the following examples, TEST_ROUTINE is a PD symbol. Its value is 500 and 
the code address in this procedure descriptor is 1000. The first example displays 
intructions starting at 520. 


EXAMINE / INSTRUCTION TEST ROUTINE/NOPD+2 0 
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The next example fetches code address from TEST_ROUTINE PD, adds 20 and 
displays instructions at that address. In other words, it displays code starting at 
location 1020. 


EXAMINE / INSTRUCTION TEST _ROUTINE+20 


The final example treates the address TEST_ROUTINE+20 as a procedure 
descriptor, so it fetches the code address out of a procedure descriptor at address 
520. It then uses that address to display instructions. 


EXAMINE/INSTRUCTION/PD TEST ROUTINE/NOPD+20 


IPFS 
(164 only.) Examines the specified expression in the format of a previous function 
state. 


/PHYSICAL 
Examines physical addresses. You cannot use the /PHYSICAL qualifier in 
combination with the /PO, /P1, or /SYSTEM qualifiers. 


IPS 

Examines the specified quadword, displaying its contents in the format of 
a processor status. This qualifier must precede any parameters used in the 
command line. 


/PSR 
(164 only.) Examines the specified expression in the format of a processor status 
register. 


/PTE 

Interprets and displays the specified quadword as a page table entry (PTE). The 
display separates individual fields of the PTE and provides an overall description 
of the PTE’s type. 


/SYSTEM 
Displays portions of the writable system region. Do not specify parameters when 
you use this qualifier. 


/TIME 
Examines the specified quadword, displaying its contents in the format of a 
system-date-and-time quadword. 


The following sections describe how to use the EXAMINE command. 


Examining Locations 

When you use the EXAMINE command to look at a location, SDA displays the 
location in symbolic notation (symbolic name plus offset), if possible, and its 
contents in hexadecimal and ASCII formats: 


SDA> EXAMINE G6605C0 
806605C0: 64646464.64646464 "dddddddd" 


If the ASCII character that corresponds to the value contained in a byte is not 
printable, SDA displays a period (.). If the specified location does not exist in 
memory, SDA displays this message: 


%SDA-E-NOTINPHYS, address : virtual data not in physical memory 
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To examine a range of locations, you can designate starting and ending locations 
separated by a colon. For example: 


SDA> EXAMINE G40:G200 


Alternatively, you can specify a location and a length, in bytes, separated by a 
semicolon. For example: 


SDA> EXAMINE G400;16 


When used to display the contents of a range of locations, the EXAMINE 
command displays six or ten columns of information. Ten columns are used if 
the terminal width is 132 or greater, or if a SET OUTPUT has been entered; six 
columns are used otherwise. An explanation of the columns is as follows: 


e Each of the first four or eight columns represents a longword of memory, the 
contents of which are displayed in hexadecimal format. 


e The fifth or ninth column lists the ASCII value of each byte in each longword 
displayed in the previous four or eight columns. 


e The sixth or tenth column contains the address of the first, or rightmost, 
longword in each line. This address is also the address of the first, or leftmost, 
character in the ASCII representation of the longwords. Thus, you read the 
hexadecimal dump display from right to left, and the ASCII display from left 
to right. 


If a series of virtual addresses does not exist in physical memory, SDA displays a 
message specifying the range of addresses that were not translated. 


If a range of virtual locations contains only zeros, SDA displays this message: 
Zeros suppressed from ‘'locl’ to ‘loc2’ 


Decoding Locations 

You can translate the contents of memory locations into instruction format by 
using the /INSTRUCTION qualifier. This qualifier causes SDA to display the 
location in symbolic notation (if possible) and its contents in instruction format. 
The operands of decoded instructions are also displayed in symbolic notation. The 
location must be longword aligned (Alpha) or octaword aligned (164). 

Examining Memory Regions 

You can display an entire region of virtual memory by using one or more of the 
qualifiers /ALL, /SYSTEM, /PO, and /P1 with the EXAMINE command. 

Other Uses 

Other uses of the EXAMINE command appear in the following examples. 


Note 


When examining individual locations, addresses are usually symbolized, 
as described previously. If the SET SYMBOLIZE OFF command is issued, 
addresses are not symbolized. See the SET SYMBOLIZE command for 
further details. 
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1. SDA> EXAMINE/PFS 7FF43C10 
PPL PEC RRB.PR RRB.F RRB.GR SOR SOL SOF 
0 0. 0. 0. 0. 0. 23. (32-54) 31. (32-62) 


This example shows the display produced by the EXAMINE/PFS command. 
Headings refer to previous privilege level (PPL), previous epilog count (PEC), 
Register Rename Base (RRB) for Predicate (PR), Floating (FR), and General 
(GR) Registers, Size of Rotating (SOR) or Local (SOL) portion of the stack frame 
or Size of the Stack Frame (SOF). For more information, see the Intel IA-64 
Architecture Software Developer’s Manual. 


2. SDA> EXAMINE/PS 7FF95E78 
MBZ SPAL MBZ IPL VMM MBZ CURMOD INT PRVMOD 
0 00 00000000000 08 0 0 KERN 0 _ EXEC 


This example shows the display produced by the EXAMINE/PS command. 


3. SDA> EXAMINE/PSR 7FF43C78 
RT TB LP DB SI DI PP SP DFH DFL DT PK I IC MFH MFL AC BE 
1 0 1 0 0 0 0 0 1 0 1 0 1 1 0 1 0 0 
IA BN ED RI SS DD DA ID IT MC IS CPL 
0 1 0 1 0 0 0 0 1 0 0 0 


This example shows the display produced by the EXAMINE/PSR command. 


4, SDA> EXAMINE/PTE @*QMMG$GQ_L1_ BASE 


a2. 2 2 1 wa 

109 7 0 8 65 7 6 0 
+-+-+--+-------------- +-+-+---+-4+--------------- +-+----------- +-+ 
|0|1|00| 0000 |0|x| 00|0| 11 X| 04 |0| 
+-+-+--+-------------- +-+-+---+-+4+--------------- +-+----------- +-+ 
| 00000C37 | 
+--------------------------------------------------------------- + 


Valid PTE: Read Prot = K---, Write Prot = K--- 
Owner = K, Fault on = -E--, ASM = 00, Granularity Hint = 00 
CPY = 00 PFN = 00000C37 


The EXAMINE/PTE command displays and formats the level 1 page table entry 
at FFFFFEFD.BF6FC000. For more information on interpreting this display, see 
Section 2.8. 


5. SDA> EXAMINE/CONDITION_VALUE RO 
SSYSTEM-F-NOPRIV, insufficient privilege or object protection violation 


This example shows the text associated with the condition code in RO. 


6. SDA> EXAMINE/TIME EXESGQ_SYSTIME 
12-DEC-2001 08:23:07.80 


This example displays the current system as an ASCII absolute time. 
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EXIT 
Exits from an SDA display or exits from the SDA utility. 
Format 
EXIT 
Parameters 
None. 
Qualifiers 
None. 


Description 


If SDA is displaying information on a video display terminal—and if that 
information extends beyond one screen—SDA enters display mode and displays a 
screen overflow prompt at the bottom of the screen: 


Press RETURN for more. 
SDA> 


If you want to discontinue the current display at this point, enter the EXIT 
command. If you want SDA to execute another command, enter that command. 
SDA discontinues the display as if you entered EXIT, and then executes the 
command you entered. 


When the SDA> prompt is not immediately preceded by the screen overflow 
prompt, entering EXIT causes your process to cease executing the SDA utility. 
When issued within a command procedure (either the SDA initialization file or a 
command procedure invoked with the execute (@) command), EXIT causes SDA to 
terminate execution of the procedure and return to the SDA prompt. 


See Section 2.6.2 for a description of SDA display mode. 
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Format 


Parameter 


Qualifiers 


Description 


Displays a formatted list of the contents of a block of memory. 


FORMAT [/TYPE=block-type] location [/NOSYMBOLIZE]|/PAGE]|/PHYSICAL] 
[/POSITIVE] 


location 
Location of the beginning of the data block. The location can be given as any 
valid SDA expression. 


/NOSYMBOLIZE 

If /NOSYMBOLIZE is specified, no attempt is made to symbolize the contents of 
any field in a structure. This is useful if the loaded execlet or activated image 
lists are corrupted, since symbolization relies on these lists. 


/PAGE 

If the output of the formatted structure does not fit on one screen, SDA enters 
display mode. (For information on this topic, see Section 2.6.2.) By default, SDA 
displays the formatted structure without screen overflow prompts. 


/PHYSICAL 
Specifies that the location given is a physical address. 


/POSITIVE 
Symbols that describe negative offsets from the start of the structure are ignored. 
By default, all symbols for the block type are processed. 


/TYPE=block-type 

Forces SDA to characterize and format a data block at location as the specified 
type of data structure. The /TYPE qualifier thus overrides the default behavior of 
the FORMAT command in determining the type and/or subtype of a data block, 
as described in the Description section. The block-type can be the symbolic prefix 
of any data structure defined by the operating system. 


The FORMAT command performs the following actions: 

e Characterizes a range of locations as a system data block 

e Assigns, if possible, a symbol to each item of data within the block 
e Displays all the data within the block, up to a quadword per line 


e Whenever successive quadword fields with no symbolic name containing 
the same value occur, only the first occurence is output. Ellipses replace all 
subsequent occurences. 
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Most OpenVMS control blocks include two bytes that indicate the block type 
and/or subtype at offsets 0Ajg and OByg, respectively. The type and/or subtype 
associate the block with a set of symbols that have a common prefix. Each 
symbol’s name describes a field within the block, and the value of the symbol 
represents the offset of the field within the block. 


If the type and/or subtype bytes contain a valid block type/subtype combination, 
SDA retrieves the symbols associated with that type of block (see $DYNDEF) and 
uses their values to format the block. 


For a given block type, all associated symbols have the following form: 
<block_type>$<field> <name> 
where field is one of the following: 


Byte 

Word 

Longword 

Quadword 

Octaword 

Address 

Constant 

Global Longword 

Pointer 

Structure (variable size) 
Counted ASCII string (up to 31 characters) 


If SDA cannot find the symbols associated with the block type specified in the 
block-type byte or by the /TYPE qualifier, it issues the following message: 


HAVHAAQP,rTOOHrAaAwW 


SSDA-E-NOSYMBOLS, no <block type> symbols found to format this block 


If you receive this message, you may want to read additional symbols into the 
SDA symbol table and retry the FORMAT command. Many symbols that define 
OpenVMS data structures are contained within SDA$READ_DIR:SYSDEF:‘STB. 
Thus, you would issue the following command: 


SDA> READ SDASREAD_DIR:SYSDEF.STB 


If SDA issues the same message again, try reading additional symbols. 

Table 2—4 lists additional modules provided by the OpenVMS operating system. 
Alternatively, you can create your own object modules with the MACRO-32 
Compiler for OpenVMS. See the READ command description for instructions on 
creating such an object module. 


Certain OpenVMS data structures do not contain a block type and/or subtype. If 
bytes contain information other than a block type/subtype—or do not contain a 
valid block type/subtype— SDA either formats the block in a totally inappropriate 
way, based on the contents of offsets 0A;g and OByg, or displays the following 
message: 


$SDA-E-INVBLKTYP, invalid block type in specified block 


To format such a block, you must reissue the FORMAT command, using the 
/TYPE qualifier to designate a block-type. 


The FORMAT command produces a three-column display containing the following 
information: 


e The first column shows the virtual address of each item within the block. 


e The second column lists each symbolic name associated with a location within 
the block. 
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e The third column shows the contents of each item in hexadecimal format, 


including symbolization if a suitable symbol exists. 


Examples 


1. 


SDA> READ SYSDEF 
SDA> format 81475D00 


FFFFFFFF.81475D00 UCBSL FOFL 8104EA58 


UCBSL MB MSGOFL 
UCBSL ROFL 
UCBSW MB SEED 
UCBSW UNIT SEED 


FFFFFFFF.81475D04 UCBSL FOBL~ 81412038 
UCBSL MB MSGOBL 
UCBSL ROBL 
FFFFFFFF.81475D08 UCBSW SIZE 
FFFFFFFF.81475D0A  UCBSB TYPE 10 
FFFFFFFF.81475D0B | UCBSB FLCK 3A 
FFFFFFFF.81475D0C UCBSL ASTOFL 81223888 
UCBSL FPC 


UCB$L_MB W AST 
UCB$T_PARTNER 


EXES$GL_FKWAITFL+00078 


0380 


SYSSDKDRIVER+19A88 


In this example on an OpenVMS Alpha system, the READ command loads the 
symbols from SDA$READ_DIR:SYSDEF.STB into SDA’s symbol table. The 
FORMAT command displays the data structure that begins at 81475D00j¢, a unit 
control block (UCB). If a field has more than one symbolic name, all such names 
are displayed. Thus, the field that starts at 81475D0C 1. has four designations: 
UCB$L_ASTQFL, UCB$L_FPC, UCB$L_MB_W_AST, and UCB$T_PARTNER. 


The contents of each field appear to the right of the symbolic name of the field. 


Thus, the contents of UCB$L_FQBL are 8104EA584¢. 


SDA> read sysdef 

SDA> read/exec 

SDA> format 84191D00 

FFFFFFFF.84191D00  SPLS$L OWN CPU 
FFFFFFFF.84191D04 SPLS$L OWN CNT 
FFFFFFFF.84191D08 SPLS$W SIZE 
FFFFFFFF.84191D0A SPLS$B TYPE 
FFFFFFFF.84191D0B  SPLS$B SUBTYPE 
FFFFFFFF.84191D0C  SPLSL SPINLOCK 
FFFFFFFF.84191D10 SPLSL RANK 
FFFFFFFF.84191D14  SPLSB IPL 

SPLS$L IPL 
FFFFFFFF.84191D15 ~ 
FFFFFFFF.84191D18  SPLS$L RLS PC 
FFFFFFFF.84191D1C  SPLS$L BUSY WAITS 
FFFFFFFF.84191D20 SPLSL WAIT CPUS 
FFFFFFFF.84191D24  SPLS$L WAIT PC 
FFFFFFFF.84191D28 SPL$Q SPINS 
FFFFFFFF.84191D30 SPLSQ ACQ COUNT 
FFFFFFFF.84191D38 SPLS$L TIMO INT 
FFFFFFFF.84191D3C  SPLSPS SHARE ARRAY 
FFFFFFFF.84191D40 SPLSPS SHARE LINK 
FFFFFFFF.84191D44  SPLS$T NAME _ 
FFFFFFFF.84191D45 ~ 

FFFFFFFF .84191D48 

FFFFFFFF.84191D50 | SPLSQ RELEASE COUNT 
FFFFFFFF.84191D58  SPL$Q_HISTORY_BITMASK 


FFFFFFFF 


00000000 


1F 


000000 


00000000 


00000000 


00000000. 
00000000. 


00000000 


000000 


00000000. 
00000000. 
00000000. 


00000000 
0100 
4F 
01 


00000000 


00000000 
00000000 
00000000 
00008E08 
000186A0 
00000000 
00000000 


00008E08 
00000000 


UCBSM_FLOPPY_ MEDIA+006A0 
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FFFFFFFF.84191D60  SPL$Q ABUSE THRESHOLD  00000000.00000000 

FFFFFFFF.84191D68  SPL$Q_FLAGS 00000000.00000000 

FFFFFFFF .84191D70 00000000.00000000 

FFFFFFFF.84191D80  SPL$Q_ABUSE_BITMASK 00000000.00000000 

FFFFFFFF .84191D88 00000000.00000000 

FFFFFFFF .84191DB8 00000000 

FFFFFFFF.84191DBC SPLSL_VEC_INX 00000010 

FFFFFFFF.84191DC0 SPLSL_OWN_PC_VEC 8016B7A0 ERLS$WAKE_C+00370 
FFFFFFFF.84191DC4 8016BF50 ERLS$WAKE_C+00B20 
FFFFFFFF .84191DC8 8016BF50.8016B7A0 

FFFFFFFF .84191DD8 8016B8C0.8016B7A0 

FFFFFFFF .84191DE0 000231E0.00022C20 

FFFFFFFF .84191DE8 00023BF0.000238D0 

FFFFFFFF .84191DF0 000231E0.00022C20 

FFFFFFFF .84191DF8 00023BF0.000238D0 


SPL$C_LENGTH 


In this example on an OpenVMS I64 system, the READ command loads the 
symbols from SYSDEF and the loaded executive images into SDA’s symbol table. 
The FORMAT command displays the data structure that begins at 84191D004., 
a spinlock control block (SPL). If a field has more than one symbolic name, all 
such names are displayed. Thus, the field that starts at 84191D14 1g has two 
designations: SPL$B_IPL and SPL$L_IPL. 


The contents of each field appear to the right of the symbolic name of the field. 
Thus, the contents of SPL$B_IPL is 1Fj¢. 
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HELP 


Format 


Parameter 


Qualifiers 


Displays information about the SDA utility, its operation, and the format of its 


commands. 
HELP 


[topic-name] 


topic-name 


Topic for which you need information. A topic can be an SDA command name 
such as ATTACH or COPY or one of the following keywords: 


Keyword 


Function 


ANALYZE_Usage 


CLUE_ Info 
Commands 
CPU_Context 


Execute 

Initialization 

Operation 
Page_Protections 
Process_Context 
SDA_Extension_Routines 


SDA_Symbols 
SPL_Info 


Using_Expressions 


Describes the parameters and qualifiers for the 
ANALYZE/CRASH_DUMP and ANALYZE/SYSTEM 
DCL commands 


Describes SDA CLUE (Crash Log Utility Extractor) 
Provides information on specific SDA commands 


Describes the concept of CPU context as it governs 
the behavior of SDA 


Describes the use of @file to execute SDA commands 
contained in a file 


Describes the circumstances under which SDA 
executes an initialization file when first invoked 


Describes how to operate SDA at your terminal and 
by means of the site-specific startup procedure 


Describes page protections and access for Alpha and 
164 systems 


Describes the concept of process context as it governs 
the behavior of SDA 


Describes how to write, debug, and invoke an SDA 
extension and provides details of all callable routines 


Describes the symbols used by SDA 

Provides an overview of SDA SPL (Spinlock Tracing 
Utility) 

Describes use of SDA expressions 


None. 
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Description 


The HELP command displays brief descriptions of SDA commands and concepts 
on the terminal screen (or sends these descriptions to the file designated in a SET 
OUTPUT command). You can request additional information by specifying the 
name of a topic in response to the Topic? prompt. 


If you do not specify a parameter in the HELP command, it lists the features of 
SDA and those commands and topics for which you can request help, as follows: 


Example 


SDA> HELP 
HELP 


The System Dump Analyzer (SDA) allows you to inspect the contents 
of memory as saved in the dump taken at crash time or as exists 
in a running system. You can use SDA interactively or in batch 
mode. You can send the output from SDA to a listing file. You can 
use SDA to perform the following operations: 


Assign a value to a symbol 

Examine memory of any process 

Format instructions and blocks of data 
Display device data structures 

Display memory management data structures 
Display a summary of all processes on the system 
Display the SDA symbol table 

Copy the system dump file 

Read global symbols from any object module 
Search memory for a given value 

Send output to a file or device 


For help on performing these functions, use the HELP command and 
specify a topic. 


Format 


HELP [topic-name] 


Additional information available: 


Topic? 
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MAP 


Format 


Parameter 


Qualifiers 


Description 


Examples 


EXECSHI_USE_PAGEABLE CODE 00000000 000045D3 000045D4 


EXECSNONPAGED CODE 000045E0 0001B8B3 000172D4 


Transforms an address into an offset in a particular image. 


MAP address 


address 
Address to be identified. 


None. 


The MAP command identifies the image name and offset corresponding to an 
address. With this information, you can examine the image map to locate the 
source module and program section offset corresponding to an address. 


If the address is in system space, MAP searches for the specified address in 
executive images first. It then checks activated images in process space to search 
those images installed using the /RESIDENT qualifier of the Install utility. 
Finally, it checks all image-resident sections in system space. 


If the address is in process space, MAP searches the activated images for the 
process. 


If the address cannot be found, MAP displays the following message: 


@SDA-E-NOTINIMAGE, Address not within a system/installed image 


1. SDA> MAP G90308 
Image Base End Image Offset 
SYSSVM 
Nonpaged read only 80090000 800ABA00 00000308 


Examining the image map identified by this MAP command (SYS$VM.MAP) 
shows that image offset 308 falls within psect EXEC$HI_USE_PAGEABLE_ 
CODE because the psect goes from offset 0 to offset 45D3: 


kk 


17876. 
5276. 
12596. 


94932. 
604. 
2728. 


Kk 
kk 


SYSCREDEL 00000000 0000149B 0000149C 
SYSCRMPSC 000014A0 000045D3 00003134 


Kk 
kk 


EXECUTE FAULT 00004550 0000483B 0000025C 
IOLOCK 00004840 000052E7 00000AA8 
LOCK SYSTEM PAGES 


kk 


~~~ Yr ~— 
ND hw MY Le) 
omu ooo 
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Specifically, image offset 308 is located within source module SYSCREDEL. 
Therefore, to locate the corresponding code, you would look in SYSCREDEL 
for offset 308 in psect EXEC$HI_LUSE_PAGEABLE_CODE. 


SDA> MAP G550000 
Image Base End Image Offset 
SYSSDKDRIVER 80548000 80558000 00008000 


In this example, the MAP command identifies the address as an offset into 
an executive image that is not sliced. The base and end addresses are the 
boundaries of the image. 


SDA> MAP G550034 
Image Base End Image Offset 
SYSSDUDRIVER 

Nonpaged read/write 80550000 80551400 00008034 


In this example, the MAP command identifies the address as an offset into an 
executive image that is sliced. The base and end addresses are the boundaries 
of the image section that contains the address of interest. 


SDA> MAP GF0040 
Image Resident Section Base End Image Offset 
MAILSHR 800F0000 80119000 00000040 


The MAP command identifies the address as an offset into an image-resident 
section residing in system space. 


SDA> MAP 12000 
Activated Image Base End Image Offset 
MAIL 00010000 000809FF 00002000 


The MAP command identifies the address as an offset into an activated image 
residing in process-private space. 


SDA> MAP B2340 
Compressed Data Section Base End Image Offset 
LIBRTL 000B2000 000B6400 00080340 


The MAP command identifies the address as being within a compressed 
data section. When an image is installed with the Install utility using 

the /RESIDENT qualifier, the code sections are mapped in system space. 
The data sections are compressed into process-private space to reduce null 
pages or holes in the address space left by the absence of the code section. 
The SHOW PROCESS/IMAGE=ALL display shows how the data has been 
compressed; the MAP command searches this information to map an address 
in a compressed data section to an offset in an image. 


SDA> MAP 7FC06000 
Shareable Address Data Section Base End Image Offset 
LIBRTL 7FC06000 7FC16800 00090000 


The MAP command identifies the address as an offset into a shareable 
address data section residing in P1 space. 


SDA> MAP 7FC26000 
Read-Write Data Section Base End Image Offset 
LIBRTL 7FC26000 7FC27000 000B0000 


The MAP command identifies the address as an offset into a read-write data 
section residing in P1 space. 
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SDA> MAP 7FC36000 

Shareable Read-Only Data Section Base End Image Offset 
LIBRTL 7FC36000 7FC3F600 000C0000 
The MAP command identifies the address as an offset into a shareable 
read-only data section residing in P1 space. 


SDA> MAP 7FC56000 
Demand Zero Data Section Base End Image Offset 
LIBRTL 7FC56000 7FC57000 000E0000 


The MAP command identifies the address as an offset into a demand zero 
data section residing in P1 space. 
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MODIFY DUMP 


Allows a given byte, word, longword, or quadword in the dump file to be modified. 


Format 
MODIFY DUMP {/BLOCK=n/OFFSET=n1/NEXT} [/CONFIRM=n] 
{/BYTE |/WORD |/LONGWORD (d)|/QUADWORD} value 
Parameter 
value 
New value deposited in the specified location in the dump file. 
Qualifiers 
/BLOCK=n 
Indicates block number to be modified. Required unless the /NEXT qualifier is 
given. 
/OFFSET=n 
Indicates byte offset within block to be modified. Required unless the /NEXT 
qualifier is given. 
/NEXT 
Indicates that the byte or bytes immediately following the location altered by 
the previous MODIFY DUMP command are to be modified. Used instead of the 
/BLOCK=n and /OFFSET=n qualifiers. 
/CONFIRM=n 
Checks existing contents of location to be modified. 
/BYTE 
Indicates that only a single byte is to be replaced. 
/WORD 
Indicates that a word is to be replaced. 
/LONGWORD 
Indicates that a longword is to be replaced. This is the default. 
/QUADWORD 
Indicates that a quadword is to be replaced. 
Description 


The MODIFY DUMP command is used on a dump file that cannot be analyzed 
without specifying the /OVERRIDE qualifier on the ANALYZE/CRASH_DUMP 
command. You can use the MODIFY DUMP command to correct the problem 
that prevents normal analysis of a dump file. You can only use the MODIFY 
DUMP command when you have invoked SDA with the ANALYZE/CRASH_ 
DUMP/OVERRIDE command. 
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Important 


This command is not intended for general use. It is provided for the 
benefit of HP support personnel when investigating crash dumps that 
cannot be analyzed in other ways. 


If the block being modified is part of either the dump header, the error log 
buffers, or the compression map, the changes made are not seen when you issue 
the appropriate SHOW DUMP command, unless you first exit from SDA and then 
reissue the ANALYZE/CRASH_DUMP command. 


The MODIFY DUMP command sets a bit in the dump header to indicate that 
the dump has been modified. Subsequent ANALYZE/CRASH_DUMP commands 
issued to that file produce the following warning message: 


%SDA-W-DUMPMOD, dump has been modified 


Examples 


1. SDA>> MODIFY DUMP/BLOCK=10/OFFSET=100/WORD FF 
This example shows the dump file modified with the word at offset 100 in 
block 00000010 replaced by OOFF. 


2. SDA>> MODIFY DUMP/BLOCK=10/OFFSET=100/WORD 0/CONFIRM=EE 
%SDA-E-NOMATCH, expected value does not match value in dump; dump not updated 


This example shows what happens when the actual word value of O0OFF at 
offset 100 in block 00000010 does not match the given value of OOEE. 


3. SDA>> MODIFY DUMP/BLOCK=10/OFFSET=100/WORD 0/CONFIRM=FF 


This example shows the dump file modified with a word value of OOFF at 
offset 100 in block 00000010 replaced by 0000. 
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READ 


Format 


Parameters 


Qualifiers 


Loads the global symbols contained in the specified file into the SDA symbol 
table. 


READ [/[NOJLOG|/RELOCATE =expression|/SYMVA=expression]| 
{/EXECUTIVE [directory spec] |/FORCE filespec 
|/IMAGE filespec | filespec} 


directory-spec 

Name of the directory containing the loadable images of the executive. 
This parameter defaults to SDA$READ_DIR, which is a search list of 
SYS$LOADABLE_IMAGES and SYS$LIBRARY. 


filespec 

Name of the device, directory, and file that contains the file from which you 
want to read global symbols. The filespec defaults to SYS$DISK:[default- 
dir]filename.type, where SYS$DISK and [default-dir] represent the disk and 
directory specified in your last DCL command SET DEFAULT. If no type has been 
given in filespec, SDA first tries .STB and then .EXE. 


If no device or directory is given in the file specification, and the file specification 
is not found in SYS$DISK:|[default_dir], then SDA attempts to open the file 
SDA$READ_DIR:filename.type. If no type has been given in filespec, SDA first 
tries .STB and then .EXE. 


If the file name is the same as that of an execlet or image, but the symbols in the 
file are not those of the execlet or image, then you must use the /FORCE qualifier, 
and optionally /RELOCATE and /SYMVA qualifiers, to tell SDA how to interpret 
the symbols in the file. 


The READ command accepts quoted filenames for access to images on ODS-5 
disks with lowercase or compound characters in their names. 


/EXECUTIVE directory-spec 

Reads into the SDA symbol table all global symbols and global entry points 
defined within all loadable images that make up the executive. For all the 
execlets in the system, SDA reads the .STB or .EXE files in the requested 

directory. 


/FORCE filespec 

Forces SDA to read the symbols file, regardless of what other information or 
qualifiers are specified. If you do not specify the /FORCE qualifier, SDA may not 
read the symbols file if the specified filespec matches the image name in either 
the executive loaded images or the current processes activated image list, and one 
of the following conditions is true: 


e The image has a symbols vector (is a shareable image), and a symbols vector 
was not specified with the /SYMVA or /IMAGE qualifier. 
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e The image is sliced, and slicing information was not provided with the 
/IMAGE qualifier. 


e The shareable or executive image is not loaded at the same address it was 
linked at, and the relocation information was not provided with either the 
/IMAGE or /RELOCATE qualifier. 


The use of /FORCE [/SYMVA=addr] |/RELOCATE=adar] filespec is a variant of 
the /IMAGE qualifier and avoids fixing up the symbols to match an image of the 
same name. 


IMAGE filespec 

Searches the executive loaded image list and the current process activated image 
list for the image specified by filespec. If the image is found, the symbols are 
read in using the image symbol vector (if there is one) and either slicing or 
relocation information. 


This is the preferred way to read in the .STB files produced by the linker. These 
.STB files contain all universal symbols, unless SYMBOL_TABLE=GLOBAL is 
in the linker options file, in which case the .STB file contains all universal and 
global symbols. 


/LOG 

/NOLOG (D) 

The /LOG qualifier causes SDA to output the %SDA-I-READSYM message for 
each symbol table file it reads. You can specify the /LOG qualifier with any other 
combination of parameters and qualifiers. 


The /NOLOG qualifier suppresses the output of the %SDA-I-READSYM messages. 
This is the default. You can specify the /NOLOG qualifier with any other 
combination of parameters and qualifiers. 


/RELOCATE=expression 

Changes the relative addresses of the symbols to absolute addresses by adding 
the value of expression to the value of each symbol in the symbol table file to be 
read. This qualifier changes those addresses to absolute addresses in the address 
space into which the dump is mapped. 


The relocation only applies to symbols with the relocate flag set. All universal 
symbols must be found in the symbol vector for the image. All constants are read 
in without any relocation. 


If the image is sliced (image sections are placed in memory at different relative 
offsets than how the image is linked), then the /RELOCATE qualifier does not 
work. SDA compares the file name used as a parameter to the READ command 
against all the image names in the executive loaded image list and the current 
processes activated image list. If a match is found, and that image contains a 
symbol vector, an error results. At this point you can either use the /FORCE 
qualifier or the /IMAGE qualifier to override the error. 


/SYMVA=expression 

Informs SDA whether the absolute symbol vector address is for a shareable 
image (SYS$PUBLIC_VECTORS.EXE) or base system image (SYS$BASE_ 
IMAGE.EXE). All symbols found in the file with the universal flag are found by 
referencing the symbol vector (that is, the symbol value is a symbol vector offset). 
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Description 


The READ command symbolically identifies locations in memory and the 
definitions used by SDA for which the default files (SDA$READ_DIR:SYS$BASE_ 
IMAGE.EXE and SDA$READ_DIR:REQSYSDEEF.STB) provide no definition. In 
other words, the required global symbols are located in modules and symbol 
tables that have been compiled and/or linked separately from the executive. SDA 
extracts no local symbols from the files. 


The file specified in the READ command can be the output of a compiler or 
assembler (for example, an .OBJ file). 


Note 


The READ command can read both OpenVMS Alpha and OpenVMS 164 
format files. Do not use READ to read files that contain symbols specific 
to another architecture, as this might change the behavior of other SDA 
commands for the current architecture. 


Most often the file is provided in SYS$LOADABLE_IMAGES. Many SDA 
applications, for instance, need to load the definitions of system data structures 
by issuing a READ command specifying SYSDEF.STB. Others require the 
definitions of specific global entry points within the executive image. 


The files in SYS$LOADABLE_IMAGES define global locations within executive 
images, including those listed in Table 4-1. The actual list of executive images 
used varies, depending on platform type, devices, and the settings of several 
system parameters. 


Table 4-1 Modules Defining Global Locations Within Executive Images 


File Contents 

ACME.EXE $ACM system service 

CNX$DEBUG.EXE Connection Manager trace 
routines 

DDIF$RMS_EXTENSION.EXE Support for Digital Document 
Interchange Format (DDIF) file 
operations 

ERRORLOG.STB Error-logging routines and system 
services 

EXCEPTION.STB! Bugcheck and exception-handling 


routines and those system services 
that declare condition and exit 


handlers 
EXEC_INIT.STB Initialization code 
F11BXQP.STB File system support 
FC$GLOGALS.STB Fibrechannel symbols 


lVariations of these files also exist, for example, where the file name ends in "_MON." System 
parameters such as SYSTEM_CHECK determine which image is loaded. 


(continued on next page) 
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Table 4-1 (Cont.) Modules Defining Global Locations Within Executive Images 


File 


Contents 


IMAGE_MANAGEMENT.STB 


IO_ROUTINES.STB! 


LAT$RATING.EXE 


LCK$DEBUG.EXE 
LMF$GROUP_TABLE.EXE4 


LOCKING.STB 
LOGICAL_NAMES.STB 
MESSAGE_ROUTINES.STB 
MSCP.EXE 
MULTIPATH.STB! 
NET$CSMACD.EXE 


NET$FDDI.EXE 
NT_EXTENSION.EXE 


PROCESS MANAGEMENT STB! 
RECOVERY_UNIT_SERVICES.STB 
RMS.EXE 

SECURITY.STB! 


SHELL«xxK.STB 
SPL$DEBUG.EXE 
SSPLEXE 


SYS$xxDRIVER.EXE 


Image activator and the related 
system services 


$QIO system service, related 
system services (for example, 
$CANCEL and $ASSIGN), and 


supporting routines 


CPU load-balancing routines for 
LAT 


Lock manager trace routines 


Data structures for licensed 
product groups 


Lock management routines and 
system services 


Logical name routines and system 
services 


System message routines and 
system services (including 
$SNDJBC and $GETTIM) 


Disk MSCP server 


Fibrechannel multipath support 
routines 


CSMA/CD LAN management 


module 
FDDI LAN management module 


NT extensions for persona system 
services 


Scheduler, report system event, 
and supporting routines and 
system services 


Recovery unit system services 


Global symbols and entry points 
for RMS 


Security management routines 
and system services 


Process shell 
Spinlock trace routines 


Security Support Provider 
Interface 


Run-time device drivers 


1Variations of these files also exist, for example, where the file name ends in "_MON." System 
parameters such as SYSTEM_CHECK determine which image is loaded. 


4Alpha only. 


(continued on next page) 
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Table 4—1 (Cont.) Modules Defining Global Locations Within Executive Images 


File Contents 

SYS$ACPI.EXE® Advanced Configuration and 
Power Interface routines 

SYS$ATMWORKS351.EXE PCI-ATM driver 

SYS$CLUSTER.EXE OpenVMS Cluster support 


SYS$CPU_ROUTINES._xxxx.EXE4 


SYS$EW1000A.EXE 
SYS$EW5700.EXE® 
SYS$GALAXY.STB 


SYS$HWPnnnn.EXE® 
SYS$IPC_SERVICES.EXE 


SYS$IPInnnn.EXE® 
SYS$LAN.EXE 
SYS$LAN_ATM.EXE 
SYS$LAN_ATM4.EXE 


SYS$LAN_CSMACD.EXE 
SYS$LAN_FDDI.EXE 
SYS$LAN_TR.EXE 
SYS$MME_SERVICES.STB 
SYS$NETWORK_SERVICES.EXE 
SYS$NTA.STB 
SYS$xxxx_SUPPORT.EXE® 


SYS$PUBLIC_VECTORS.EXE? 
SYS$SCS.EXE 
SYS$TRANSACTION_SERVICES.EXE 
SYS$UTC_SERVICES.EXE 


SYS$VCC.STB!,4 
SYS$VM.STB 


SYS$XFCACHE.STB! 


routines 


Processor-specific data and 
initialization routines 


Gigabit Ethernet driver 
Gigabit Ethernet driver 


OpenVMS Galaxy support 
routines 


PCI support routines 


Interprocess communication for 
DECdtm and Batch/Print 


PCI support routines 
Common LAN routines 
LAN routines for ATM 


LAN routines for ATM 
(ForeThought) 


LAN routines for CSMA/CD 
LAN routines for FDDI 

LAN routines for Token Ring 
Media Management Extensions 


DECnet support 
NT affinity routines and services 


Processor-specific data and 
initialization routines 


System service vector base image 
System Communication Services 
DECdtm services 


Universal Coordinated Time 
services 


Virtual I/O cache 
System pager and swapper, along 


with their supporting routines, 
and management system services 


Extented File Cache 


lVariations of these files also exist, for example, where the file name ends in "MON." System 
parameters such as SYSTEM _CHECK determine which image is loaded. 


2This file is located in SYS$LIBRARY. 
4Alpha only. 
5164 only. 
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Table 4-1 (Cont.) Modules Defining Global Locations Within Executive Images 


File Contents 
SYSDEVICE.STB Mailbox driver and null driver 
SYSGETSYI.STB Get System Information system 


SYSLDR_DYN.STB 
SYSLICENSE.STB 


SYSTEM_DEBUG.EXE 
SYSTEM_PRIMITIVES.STB! 


SYSTEM_SYNCHRONIZATION.STB! 


TCPIP$BGDRIVER.STB? 
TCPIP$INETACP.STB? 
TCPIP$INETDRIVER.STB? 
TCPIP$INTERNET_SERVICES.STB? 
TCPIP$NFS_SERVICES.STB? 


TCPIP$PROXY_SERVICES.STB? 


TCPIP$PWIPACP.STB?2 
TCPIP$PWIPDRIVER.STB? 
TCPIP$TNDRIVER.STB? 


TMSCP.EXE 
VMS_EXTENSION.EXE 


service ($GETSYI) 
Dynamic executive image loader 


Licensing system service 
($LICENSE) 


XDelta and SCD routines 


Miscellaneous basic system 
routines, including those that 
allocate system memory, maintain 
system time, create fork processes, 
and control mutex acquisition 


Routines that enforce 
synchronization 


TCP/IP internet driver 
TCP/IP internet ACP 

TCP/IP internet driver 
TCP/IP internet execlet 


Symbols for the TCP/IP NFS 
server 


Symbols for the TCP/IP proxy 
execlet 


TCP/IP PWIP ACP 
TCP/IP PWIP driver 


TCP/IP TELNET/RLOGIN server 
driver 


Tape MSCP server 


VMS extensions for persona 
system services 


1Variations of these files also exist, for example, where the file name ends in "_MON." System 
parameters such as SYSTEM_CHECK determine which image is loaded. 


3Only available if TCP/IP has been installed. These are found in SYS$SYSTEM, and are not 
automatically read in when you issue a READ/EXEC command. 


SDA can also read symbols from an image .EXE or .STB produced by the linker. 
The STB and EXE files only contain universal symbols. The STB file, however, 
can be forced to have global symbols for the image if you use the SYMBOL_ 
TABLE=GLOBAL option in the linker options file. 


A number of ready-built symbol table files ship with OpenVMS. They can be 
found in the directory SYS$LOADABLE_IMAGES, and all have names of the 
form xyzDEF.STB. Of these files, SDA automatically reads REQSYSDEF.STB 
on activation. You can add the symbols in the other files to SDA’s symbol table 
using the READ command. Table 2-4 lists the files that OpenVMS provides in 
SYS$LOADABLE_IMAGES that define data structure offsets. 
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READ 
The following MACRO program, GLOBALS.MAR, shows how to obtain symbols 
in addition to those in SYS$BASE_IMAGE.EXE, other executive images listed in 
Table 4-1, and the symbol table files that are listed in Table 2-4: 
. TITLE GLOBALS 
; n.b. on following lines GLOBAL must be capitalized 
SPHDDEF GLOBAL ; Process header definitions 
SDDBDEF GLOBAL + Device data block 
SUCBDEF GLOBAL + Unit control block 
SVCBDEF GLOBAL + Volume control block 
SACBDEF GLOBAL + AST control block 
SIRPDEF GLOBAL ; I/0 request packet 
+; more can be inserted here 
END 
Use the following command to generate an object module file containing the 
globals defined in the program: 
SMACRO GLOBALS+SYSSLIBRARY:LIB/LIBRARY /OBJECT=GLOBALS.STB 
Examples 


1. SDA> READ SDAS$READ_DIR:SYSDEF.STB/LOG 
%SDA-I-READSYM, 10010 symbols read from SYSSCOMMON: [SYSEXE]SYSDEF.STB;1 


The READ command causes SDA to add all the global symbols in SDA$READ_ 
DIR:SYSDEF.STB to the SDA symbol table. Such symbols are useful when you 
are formatting an I/O data structure, such as a unit control block or an I/O 
request packet. 


2. SDA> SHOW STACK 
Process stacks (on CPU 00) 


Current operating stack (KERNEL): 


00000000.7FF95CD0 FFFFFFFF.80430CE0 SCHS$STATE_TO COM+00040 
00000000.7FF95CD8 00000000.00000000 

00000000.7FF95CEO0 FFFFFFFF.81E9CB04 LNMS$SEARCH ONE C+000E4 
00000000.7FF95CE8 FFFFFFFF.8007A988 PROCESS MANAGEMENT NPRO+0E988 

SP =>00000000.7FF95CFO 00000000.00000000 _ ~ 

00000000.7FF95CF8 00000000.006080C1 

00000000.7FF95D00 FFFFFFFF.80501FDC 

00000000.7FF95D08 FEFFFFFF.81A5B720 
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SDA> READ/IMAGE SYS$LOADABLE_IMAGES:PROCESS MANAGEMENT/LOG 
$SDA-I-READSYM, 767 symbols read from SYSSCOMMON: [SYSSLDR]PROCESS MANAGEMENT.STB;1 


SDA> SHOW STACK 


Process stacks (on CPU 00) 


Current operating stack (KERNEL): 


00000000. 7FF95CD0 
00000000. 7FF95CD8 
00000000. 7FF95CE0 
00000000. 7FF95CE8 
SP =>00000000.7FF95CF0 
00000000. 7FF95CF8 
00000000. 7FF95D00 
00000000. 7FF95D08 


FFFFFFFF. 
00000000. 
FFFFFFFF. 
FFFFFFFF. 
00000000. 
00000000. 
FFFFFFFF. 
FFFFFFFF. 


80430CE0 SCHS$FIND_NEXT PROC 
00000000 

81E9CB04 LNMS$SEARCH_ONE C+000E4 
8007A988 SCHSINTERRUPT+00068 
00000000 

006080C1 

80501FDC 

81A5B720 


The initial SHOW STACK command contains an address that SDA resolves 
into an offset from the PROCESS_MANAGEMENT executive image. The READ 
command loads the corresponding symbols into the SDA symbol table such that 
the reissue of the SHOW STACK command subsequently identifies the same 
location as an offset within a specific process management routine. 
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REPEAT 
Repeats execution of the last command issued. On terminal devices, the KPO 
key performs the same function as the REPEAT command with no parameter or 
qualifier. 

Format 
REPEAT  [count!/UNTIL=condition] 

Parameter 
count 
Number of times the previous command is to be repeated. The default is a single 
repeat. 

Qualifier 


/UNTIL=condition 
Defines a condition that terminates the REPEAT command. By default, there is 
no terminating condition. 


Description 


The REPEAT command is useful for stepping through a linked list of data 
structures, or for examining a sequence of memory locations. When used with 
ANALYZE/SYSTEM, it allows the changing state of a system location or data 
structure to be monitored. 


Examples 


' SDA> SPAWN CREATE SDATEMP.COM 


SEARCH 0:3FFFFFFF 12345678 
SET PROCESS/NEXT 
“ 

SDA> SET PROCESS NULL 

SDA> @SDATEMP 

SDA> REPEAT/UNTIL = BADPROC 


This example demonstrates how to search the address space of each process in a 
system or dump a given pattern. 


2. SDA> SHOW CALL FRAME 
Call Frame Information 
Stack Frame Procedure Descriptor 
Flags: Base Register = FP, Jacket, Native 
Procedure Entry: FFFFFFFF.80080CE0 MMGSRETRANGE C+00180 
Return address on stack = FFFFFFFF.8004CF30 EXCEPTION NPRO+00F30 
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7FF95E80 FFFFFFFF.FFFFFFFD Saved R2 
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7FF95E88 FFFFFFFF.8042DBC0 Saved R3 EXCEPTION NPRW+03DC0 


TFF95E90 FFFFFFFF.80537240 Saved R4 
TFF95E98 00000000.00000000 Saved R5 


7FF95EAO FFFFFFFF.80030960 Saved R6 MMG$IMGRESET_C+00200 


TFF95EA8 00000000.7FF95ECO Saved R7 


7FF95EBO FFFFFFFF.80420E68 Saved R13 MMGSULKGBLWSL E 


TFF95EB8 00000000.7FF95F70 Saved R29 


SDA> SHOW CALL_FRAME/NEXT_FRAME 


Call Frame Information 
Stack Frame Procedure Descriptor 
Flags: Base Register = FP, Jacket, Native 
Procedure Entry: FFFFFFFF.80F018D0 


Return address on stack = FFFFFFFF.8004CF30 


Registers saved on stack 


7FF95F90 FFFFFFFF.FFFFFFFB Saved R2 


IMAGE MANAGEMENT PRO+078D0 


EXCEPTION _NPRO+00F30 


7FF95F98 FFFFFFFF.8042DBC0 Saved R3 EXCEPTION NPRW+03DC0 


TFF95FA0 00000000.00000000 Saved R5 
TFF95FA8 00000000.7FF95FCO Saved R7 


7FF95FBO FFFFFFFF.80EF8D20 Saved R13 ERLSDEVINF 0+00C20 


TFF95FB8 00000000.7FFA0450 Saved R29 


SDA> REPEAT 
Call Frame Information 
Stack Frame Procedure Descriptor 
Flags: Base Register = FP, Jacket, Native 
Procedure Entry: FFFFFFFF.80F016A0 


Return address on stack = 00000000.7FF2451C 


Registers saved on stack 


7FFA0470 00000000. 7FEEA890 Saved R13 
7FFA0478 00000000.7FFA0480 Saved R29 


IMAGE MANAGEMENT PRO+076A0 


The first SHOW CALL_FRAME displays the call frame indicated by the current 
FP value. Because the /NEXT_FRAME qualifier to the instruction displays the 
call frame indicated by the saved frame in the current call frame, you can use the 
REPEAT command to repeat the SHOW CALL_FRAME/NEXT_FRAME command 


and follow a chain of call frames. 
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SEARCH 


Scans a range of memory locations for all occurrences of a specified value. 


Format 
SEARCH _[/qualifier] range [=] expression 


Parameters 


range 
Location in memory to be searched. A location can be represented by any valid 
SDA expression. To search a range of locations, use the following syntax: 


m:n Range of locations to be searched, from m to n 
m;n Range of locations to be searched, starting at m and continuing for n bytes 


expression 

Value for which SDA is to search. SDA evaluates the expression and searches 
the specified range of memory for the resulting value. For a description of SDA 
expressions, see Section 2.6.1. 


If you do not use an equals sign to separate range and expression, then you 
must insert a space between them. 


Qualifiers 


/LENGTH={QUADWORD| LONGWORD| WORD | BYTE } 

Specifies the size of the expression value that the SEARCH command uses for 
matching. If you do not specify the /LENGTH qualifier, the SEARCH command 
uses a longword length by default. 


/MASK=n 

Allows the SEARCH command finer qranularity in its matches. It compares only 
the given bits of a byte, word, longword, or quadword. To compare bits when 
matching, you set the bits in the mask; to ignore bits when matching, you clear 
the bits in the mask. 


/PHYSICAL 
Specifies that the addresses used to define the range of locations to be searched 
are physical addresses. 


/STEPS={QUADWORD|LONGWORD| WORD | BYTE| value } 

Specifies the step factor of the search through the specified memory range. After 
the SEARCH command has performed the comparison between the value of 
expression and memory location, it adds the specified step factor to the address 
of the memory location. The resulting location is the next location to undergo the 
comparison. If you do not specify the /STEPS qualifier, the SEARCH command 
uses a step factor of a longword. 


Description 


SEARCH displays each location as each value is found. If you press Ctrl/T 
while using the SEARCH command, the system displays how far the search has 
progressed. The progress display is always output to the terminal even if a SET 
OUTPUT <file> command has previously been entered. 
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Examples 


1. 


SDA> SEARCH GB81F0;500 B41B0000 
Searching from FFFFFFFF.800B81F0 to FFFFFFFF.800B86EF in LONGWORD steps for B41B0000... 
Match at FFFFFFFF.800B86E4 B41B0000 


This SEARCH command finds the value B41B0000 in the longword at 
FFFFFFFF.800B86E4. 


SDA> SEARCH 80000000;200/STEPS=BYTE 82 
Searching from FFFFFFFF.80000000 to FFFFFFFF.800001FF in BYTE steps for 00000082... 
Match at FFFFFFFF.8000012C 00000082 


This SEARCH command finds the value 00000082 in the longword at 
FFFFFFFF.8000012C. 


SDA> SEARCH/LENGTH=WORD 80000000;100 10 
Match at FFFFFFFF.80000030 0010 
Match at FFFFFFFF.80000040 0010 
Match at FFFFFFFF.80000090 0010 
Match at FFFFFFFF.800000A0 0010 
Match at FFFFFFFF.800000C0 0010 

5 matches found 


This SEARCH command finds the value 0010 in the words at 
FFFFFFFF.80000030, FFFFFFFF.80000040, FFFFFFFF.80000090, 
FFFFFFFF.800000A0, FFFFFFFF.800000CO. 


SDA> SEARCH/MASK=FF000000 80000000;40 20000000 

Searching from FFFFFFFF.80000000 to FFFFFFFF.8000003F in LONGWORD steps for 20000000... 
(Using search mask of FF000000) 

Match at FFFFFFFF.80000000 201F0104 

Match at FFFFFFFF.80000010 201F0001 

2 matches found 


This SEARCH command finds the value 20 in the upper byte of the longwords at 
FFFFFFFF.80000000 and FFFFFFFF.80000010, regardless of the contents of the 
lower 3 bytes. 
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SET CPU 
When analyzing a system dump, selects a processor to become the current CPU 
for SDA. When invoked under ANALYZE/SYSTEM, SET CPU lists the database 
address for the specified CPU before exiting with the message: 
$SDA-E-CMDNOTVLD command not valid on the running system 

Format 
SET CPU cpu-id 

Parameter 
cpu-id 
Numeric value from 001g to 1F jg indicating the identity of the processor to be 
made the current CPU. If you specify a value outside this range or a cpu-id of a 
processor that was not active at the time of the system failure, SDA displays the 
following message: 
$SDA-E-CPUNOTVLD, CPU not booted or CPU number out of range 

Qualifiers 


None. 


Description 


When you invoke SDA to examine a system dump, the current CPU context 

for SDA defaults to that of the processor that caused the system to fail. When 
analyzing a system failure from a multiprocessing system, you may find it useful 
to examine the context of another processor in the configuration. 


The SET CPU command changes the current CPU context for SDA to that of the 
processor indicated by epu-id. The CPU specified by this command becomes the 
current CPU for SDA until you either exit from SDA or change the CPU context 
for SDA by issuing one of the following commands: 


SET CPU cpu-id 

SHOW CPU epu-id 

SHOW CRASH 

SHOW MACHINE _CHECK cpu-id 


Changing CPU context can cause an implicit change in process context under the 
following circumstances: 


e If there is a current process on the CPU made current, SDA changes its 
process context to that of that CPU’s current process. 


e If there is no current process on the CPU made current, the SDA process 
context is undefined and no process-specific information is available until you 
set the SDA process context to that of a specific process. 


The following commands also change the CPU context for SDA to that of the CPU 
on which the process was most recently current: 


SET PROCESS process-name 
SET PROCESS/ADDRESS=pcb-address 
SET PROCESS/INDEX=nn 
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SET PROCESS/NEXT 

SHOW PROCESS process-name 

SHOW PROCESS/ADDRESS=pceb-address 
SHOW PROCESS/INDEX=nn 

SHOW PROCESS/NEXT 


See Section 2.5 for further discussion of the way in which SDA maintains its 
context information. 
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SET ERASE_SCREEN 


Format 


Parameters 


Qualifiers 


Description 


Examples 


Enables or disables the automatic clearing of the screen before each new page of 
SDA output. 


SET ERASE_SCREEN {ON|OFF} 


ON 
Enables the screen to be erased before SDA outputs a new heading. This setting 
is the default. 


OFF 
Disables the erasing of the screen. 


None. 


SDA’s usual behavior is to erase the screen and then show the data. By setting 
the OFF parameter, the clear screen action is replaced by a blank line. This 
action does not affect what is written to a file when the SET LOG or SET 
OUTPUT commands are used. 


1. SDA> SET ERASE SCREEN ON 


The clear screen action is now enabled. 


2. SDA> SET ERASE SCREEN OFF 


The clear screen action is disabled. 
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SET FETCH 


Sets the default size and access method of address data used when SDA evaluates 
an expression that includes the @ unary operator. 


Format 
SET FETCH [{QUADWORD!LONGWORD!WORD1BYTE}IL,][{PHYSICAL | VIRTUAL}] 
Parameters 
QUADWORD 
Sets the default size to 8 bytes. 
LONGWORD 
Sets the default size to 4 bytes. 
WORD 
Sets the default size to 2 bytes. 
BYTE 
Sets the default size to 1 byte. 
PHYSICAL 
Sets the default access method to physical addresses. 
VIRTUAL 
Sets the default access method to virtual addresses. 
You can specify only one parameter out of each group. If you are changing both 
size and access method, separate the two parameters by spaces or a comma. 
Include a comma only if you are specifying a parameter from both groups. See 
Example 6. 
Qualifiers 
None. 
Description 
Sets the default size and/or default access method of address data used by the 
@ unary operator in commands such as EXAMINE and EVALUATE. SDA uses 
the current default size unless it is overridden by the *Q, *L, *W, or *B qualifier 
on the @ unary operator in an expression. SDA uses the current default access 
method unless it is overridden by the *P or *V qualifier on the @ unary operator 
in an expression. 
Examples 


1. SDA> EXAMINE MMG$GQ SHARED VA PTES 
MMG$GQ SHARED VA_PTES: FFFFFFFD.FF7FE000 Mog Chie: sie e's " 


This example shows the location’s contents of a 64-bit virtual address. 
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SDA> SET FETCH LONG 
SDA> EXAMINE @MMG$GQ SHARED VA PTES 
$SDA-E-NOTINPHYS, FFFFFFFF.FF7FE000 : virtual data not in physical memory 


This example shows a failure because the SET FETCH LONG causes SDA 
to assume that it should take the lower 32 bits of the location’s contents as a 
longword value, sign-extend them, and use that value as an address. 


SDA> EXAMINE @“QMMG$GQ_ SHARED VA _PTES 

FFFFFFFD.FF7FE000: 000001D0.40001119 ees ree 

This example shows the correct results by overriding the SET FETCH LONG 
with the *Q qualifier on the @ operator. SDA takes the full 64 bits of the 
location’s contents and uses that value as an address. 


SDA> SET FETCH QUAD 
SDA> EXAMINE @MMG$GQ_ SHARED VA _PTES 
FFFFFFFD.FF7FE000: 000001D0.40001119 Mate Miia’ 


This example shows the correct results by changing the default fetch size to a 
quadword. 


SDA> SET FETCH PHYSICAL 
SDA> EXAMINE /PHYSICAL @0 


This command uses the contents of the physical location 0 as the physical 
address of the location to be examined. 


SDA> SET FETCH QUADWORD, PHYSICAL 


This command sets the default fetch size and default access method at the 
same time. 
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SET LOG 


Format 


Parameter 


Qualifiers 


Description 


Initiates or discontinues the recording of an SDA session in a text file. 


SET [NOJLOG _filespec 


filespec 

Name of the file in which you want SDA to log your commands and their output. 
The default filespec is SYS$DISK:[default_dir/filename.LOG, where SYS$DISK 
and [default-dir] represent the disk and directory specified in your last DCL 
command SET DEFAULT. You must specify a file name. 


None. 


The SET LOG command echoes the commands and output of an SDA session to a 
log file. The SET NOLOG command terminates this behavior. 


The following differences exist between the SET LOG command and the SET 
OUTPUT command: 


e When logging is in effect, your commands and their results are still displayed 
on your terminal. The SET OUTPUT command causes the displays to be 
redirected to the output file and they no longer appear on the screen. 


e If an SDA command requires that you press Return to produce successive 
screens of display, the log file produced by SET LOG will record only those 
screens that are actually displayed. SET OUTPUT, however, sends the entire 
output of any SDA commands to its listing file. 


e The SET LOG command produces a log file with a default file type of .LOG; 
the SET OUTPUT command produces a listing file whose default file type is 
.LIS. 


e The SET OUTPUT command can generate a table of contents, each item 
of which refers to a display written to its listing file) SET OUTPUT also 
produces running heads for each page of output. The SET LOG command 
does not produce these items in its log file. 


If you use the SET OUTPUT command to redirect output to a listing file, a SET 
LOG command to direct the same output to a log file is ineffective until output is 
restored to the terminal. 


SDA Commands 4-53 


SDA Commands 
SET OUTPUT 


SET OUTPUT 


Redirects output from SDA to the specified file or device. 


Format 

SET OUTPUT  [/[NO]JINDEX1/[NOJHEADERI! /PERMANENT |/SINGLE_COMMAND] 
filespec 

Parameter 
filespec 
Name of the file to which SDA is to send the output generated by its commands. 
The default filespec is SYS$DISK:[default_dir] filename.LIS, where SYS$DISK 
and [default-dir] represent the disk and directory specified in your last 
DCL command SET DEFAULT. You must specify a file name except when 
/PERMANENT is specified. 

Qualifiers 
[INDEX 
/NOINDEX 


The /INDEX qualifer causes SDA to include an index page at the beginning of 
the output file. This is the default, unless you specify /NOHEADER or modify the 
default with a SET OUTPUT/PERMANENT command. The /NOINDEX qualifier 
causes SDA to omit the index page from the output file. 


/HEADER 

/NOHEADER 

The /HEADER qualifier causes SDA to include a heading at the top of each 
page of the output file. This is the default unless you modify it with a SET 
OUTPUT/PERMANENT command. The /NOHEADER qualifier causes SDA to 
omit the page headings. Use of /NOHEADER implies /NOINDEX. 


/PERMANENT 

Modifies the defaults for /[NO]HEADER and /[NO]INDEX. Specify either or both 
qualifiers with or without a NO prefix to set new defaults. Setting the default 

to /NOHEADER implies a default of /NOINDEX. The new defaults remain in 
effect until another SET OUTPUT/PERMANENT command is entered or the SDA 
session is ended. 


You cannot combine /PERMANENT and /SINGLE_COMMAND in one command, 
and you cannot provide a filespec with /PERMANENT. 


/SINGLE_COMMAND 

Indicates to SDA that the output for a single command is to be written to the 
specified file and that subsequent output should be written to the terminal. 
/SINGLE_COMMAND cannot be combined with /PERMANENT. 
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When you use the SET OUTPUT command to send the SDA output to a file or 
device, SDA continues displaying the SDA commands that you enter but sends 
the output generated by those commands to the file or device you specify. (See the 
description of the SET LOG command for a list of differences between the SET 
LOG and SET OUTPUT commands.) 


When you finish directing SDA commands to an output file and want to return to 
interactive display, issue the following command: 


SDA> SET OUTPUT SYSSOUTPUT 


You do not need this command when you specify the /SINGLE_COMMAND 
qualifier on the original SET OUTPUT command. 


If you use the SET OUTPUT command to send the SDA output to a listing file 
and do not specify /NOINDEX or /NOHEADER, SDA builds a table of contents 
that identifies the displays you selected and places the table of contents at the 
beginning of the output file. The SET OUTPUT command formats the output into 
pages and produces a running head at the top of each page, unless you specify 
/NOHEADER. 


Note 


See the description of the DUMP command for use of SET 
OUTPUT/NOHEADER. 
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SET PROCESS 


Selects a process to become the SDA current process. 


Format 


SET PROCESS {/ADDRESS=pcb-address| process-name | /ID=nn| 
/INDEX=nn1|/NEXT |/SYSTEM} 


Parameter 


process-name 

Name of the process to become the SDA current process. The process-name can 
contain up to 15 uppercase letters, numerals, the underscore (_), dollar sign ($), 
colon (:), and some other printable characters. If it contains any other characters 
(including lowercase letters), you may need to enclose the process-name in 
quotation marks (""). 


Qualifiers 


/ADDRESS=pcb-address 
Specifies the process control block (PCB) address of a process in order to display 
information about the process. 


AD=nn 

ANDEX=nn 

Specifies the process for which information is to be displayed by its index into 
the system’s list of software process control blocks (PCBs), or by its process 
identification. You can supply the following values for nn: 


e The process index itself. 


e The process identification (PID) or extended PID longword, from which SDA 
extracts the correct index. The PID or extended PID of any thread of a 
process with multiple kernel threads may be specified. Any thread-specific 
data displayed by further commands will be for the given thread. 


To obtain these values for any given process, issue the SDA command SHOW 
SUMMARY/THREADS. The /[D=nn and /INDEX=nn qualifiers can be used 
interchangeably. 


/NEXT 

Causes SDA to locate the next valid process in the process list and select that 
process. If there are no further valid processes in the process list, SDA returns 
an error. 


/SYSTEM 

Specifies the new current process by the system process control block (PCB). The 
system PCB and process header (PHD) parallel the data structures that describe 
processes. They contain the system working set list, global section table, and 
other systemwide data. 
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When you issue an SDA command such as EXAMINE, SDA displays the contents 
of memory locations in its current process. To display any information about 
another process, you must change the current process with the SET PROCESS 
command. 


When you invoke SDA to analyze a crash dump, the process context defaults 

to that of the process that was current at the time of the system failure. If the 
failure occurred on a multiprocessing system, SDA sets the CPU context to that 
of the processor that caused the system to fail. The process context is set to that 
of the process that was current on that processor. 


When you invoke SDA to analyze a running system, its process context defaults 
to that of the current process, that is, the one executing SDA. 


The SET PROCESS command changes the current SDA process context to that of 
the process indicated by process-name, pcb-address, or /INDEX=nn. The process 
specified by this command becomes the current process for SDA until you either 
exit from SDA or change SDA process context by issuing one of the following 
commands: 


SET PROCESS process-name 

SET PROCESS/ADDRESS=pcb-address 
SET PROCESS/INDEX=nn 

SET PROCESS/NEXT 

SET PROCESS/SYSTEM 

SHOW PROCESS process-name 

SHOW PROCESS/ADDRESS=pcb-address 
SHOW PROCESS/INDEX=nn 

SHOW PROCESS/NEXT 

SHOW PROCESS/SYSTEM 


When you analyze a crash dump from a multiprocessing system, changing process 
context causes a switch of CPU context as well. When you issue a SET PROCESS 
command, SDA automatically changes its CPU context to that of the CPU on 
which that process was most recently current. 


The following commands will also switch process context when analyzing a 
system dump, if there was a current process on the target CPU at the time of the 
crash: 


SET CPU ecpu-id 

SHOW CPU cpu-id 

SHOW CRASH 

SHOW MACHINE_CHECK cpu-id 


See Section 2.5 for further discussion of the way in which SDA maintains its 
context information. 
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Example 


SDA> SET PROCESS/ADDRESS=80D772C0 
SDA> SHOW PROCESS 
Process index: 0012 Name: ERRFMT Extended PID: 00000052 
Process status: 02040001  RES,PHDRES,INTER 
status2: 00000001 QUANTUM_RESCHED 


PCB address 80D772C0 JIB address 80556600 
PHD address 80477200 Swapfile disk address 01000F01 
KTB vector address 80D775AC HWPCB address 81260080 
Callback vector address 00000000 Termination mailbox 0000 
Master internal PID 00010004 Subprocess count 0 
Creator extended PID 00000000 Creator internal PID 00000000 
Previous CPU Id 00000000 Current CPU Id 00000000 
Previous ASNSEQ 0000000000000001 Previous ASN 000000000000002E 


Initial process priority & Delete pending count 0 

# open files allowed left 100 Direct I/O count/limit 150/150 
UIC [00001,000004] Buffered I/0 count/limit 149/150 
Abs time of last event 0069D34E BUFIO byte count/limit 99424/99808 
ASTs remaining 247 # of threads il 
Swapped copy of LEFC0 00000000 Timer entries allowed left 63 
Swapped copy of LEFC1 00000000 Active page table count 4 
Global cluster 2 pointer 00000000 Process WS page count 32 
Global cluster 3 pointer 00000000 Global WS page count 31 


The SET PROCESS command switches SDA’s current process context to the 
process whose PCB is at address 80D772C0. The SHOW PROCESS command 
shows that the process is ERRFMT, and displays information from its PCB and 
job information block (JIB). 


See the description of the REPEAT command for an example of the use of the 
SET PROCESS/NEXT command. 
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SET RMS 


Format 


Parameter 


Changes the options shown by the SHOW PROCESS/RMS command. 


SET RMS =(option[,...]) 


option 
Data structure or other information to be displayed by the SHOW PROCESS/RMS 
command. Table 4—2 lists those keywords that may be used as options. 


Table 4-2 SET RMS Command Keywords for Displaying Process RMS 


Information 
Keyword Meaning 
[NOJALL|:ifil! All control blocks (default) 
[NO]JASB Asynchronous save block 
[NO]BDB Buffer descriptor block 
[NO]BDBSUM BDB summary page 
[NO]BLB Buffer lock block 
[NO]JBLBSUM Buffer lock summary page 
[NO]CCB Channel control block 
[NO]DRC Directory cache 
[NO]FAB File access block 
[NO]FCB File control block 
NOJFSB File statistics block 
[NO] FWA File work area 
[NO]GBD Global buffer descriptor 
[NO]GBDSUM GBD summary page 
[NO]GBH Global buffer header 
[NO]GBHSH Global buffer hash table 
[NO]GBSB Global buffer synchronization block 
[NO]IDX Index descriptor 
[NOJIFAB[:ifi] 1 Internal FAB 
[NOJIFB[:ifi]? Internal FAB 
[NO]ITRAB Internal RAB 
[NO]IRB Internal RAB 
[NO] JFB Journaling file block 
[NO]KLTB Key-less-than block 


1The optional parameter ifi is an internal file identifier. The default ifi (ALL) is all the files the 
current process has opened. 


(continued on next page) 
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Table 4-2 (Cont.) SET RMS Command Keywords for Displaying Process RMS 
Information 
Keyword Meaning 
[NO]JNAM Name block 
[NO]JNWA Network work area 
[NO]PIO Process-permanent I/O data structures used instead of 
process image data structures 
[NO]RAB Record access block 
[NO]RLB Record lock block 
[NO]RU Recovery unit structures, including the recovery unit block 
(RUB), recovery unit stream block (RUSB), and recovery 
unit file block (RUFB) 
[NO]SFSB Shared file synchronization block 
[NO]WCB Window control block 
[NO]XAB Extended attribute block 
[NO]* Current list of options displayed by the SHOW RMS 
command 
The default option is option=(ALL,NOPIO), designating for display by the 
SHOW PROCESS/RMS command all structures for all files related to the process 
image I/O. 
To list more than one option, enclose the list in parentheses and separate options 
by commas. You can add a given data structure to those displayed by ensuring 
that the list of keywords begins with the asterisk (*) symbol. You can delete a 
given data structure from the current display by preceding its keyword with NO. 
Qualifiers 
None. 
Description 


The SET RMS command determines the data structures to be displayed by the 
SHOW PROCESS/RMS command. (See the examples included in the discussion 
of the SHOW PROCESS command for information provided by various displays.) 
You can examine the options that are currently selected by issuing a SHOW RMS 
command. 
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Examples 


1. 


SDA> SHOW RMS 
RMS Display Options: IFB,IRB,IDX,BDB,BDBSUM,ASB,CCB,WCB,FCB,FAB,RAB,NAM,XAB,RLB, 
BLB, BLBSUM, GBD, GBH, FWA, GBDSUM, JFB, NWA, RU, DRC, SFSB, GBSB 


Display RMS structures for all IFI values. 


SDA> SET RMS=IFB 
SDA> SHOW RMS 


RMS Display Options: IFB 


Display RMS structures for all IFI values. 


The first SHOW RMS command shows the default selection of data structures 
that are displayed in response to a SHOW PROCESS/RMS command. The SET 
RMS command selects only the IFB to be displayed by subsequent SET/PROCESS 
commands. 


SDA> SET RMS=(*,BLB,BLBSUM,RLB) 
SDA> SHOW RMS 


RMS Display Options: IFB,RLB,BLB,BLBSUM 


Display RMS structures for all IFI values. 


The SET RMS command adds the BLB, BLBSUM, and RLB to the list of data 
structures currently displayed by the SHOW PROCESS/RMS command. 


SDA> SET RMS=(*,NORLB, IFB:05) 
SDA> SHOW RMS 


RMS Display Options: IFB,BLB,BLBSUM 
Display RMS structures only for IFI=5. 


The SET RMS command removes the RLB from those data structures displayed 
by the SHOW PROCESS/RMS command and causes only information about the 
file with the ifi of 5 to be displayed. 


SDA> SET RMS=(*,PIO) 


The SET RMS command indicates that the data structures designated for display 
by SHOW PROCESS/RMS be associated with process-permanent I/O instead of 
image I/O. 
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SET SIGN_EXTEND 


Format 


Parameters 


Qualifiers 


Description 


Examples 


Enables or disables the sign extension of 32-bit addresses. 


SET SIGN_EXTEND {ON|! OFF} 


ON 
Enables automatic sign extension of 32-bit addresses with bit 31 set. This is the 
default. 


OFF 
Disables automatic sign extension of 32-bit addresses with bit 31 set. 


None. 


The 32-bit SO/S1 addresses need to be sign-extended to access 64-bit SO/S1 space. 
To do this, specify explicitly sign-extended addresses, or set the sign-extend 
command to ON, which is the default. 


However, to access addresses in P2 space, addresses must not be sign-extended. 
To do this, specify a zero in front of the address, or set the sign-extend command 
to OFF. 


1. SDA> SET SIGN EXTEND ON 
SDA> examine 80400000 
FFFFFFFF.80400000: 23DEFF90.4A607621 


This shows the SET SIGN_EXTEND command as ON. 
2. SDA> SET SIGN EXTEND OFF 


SDA> EXAMINE 80400000 
SSDA-E-NOTINPHYS, 00000000.80400000: virtual data not in physical memory 


This shows the SET SIGN_EXTEND command as OFF. 
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SET SYMBOLIZE 


Format 


Parameters 


Qualifiers 


Examples 


Enables or disables symbolization of addresses in the display from an EXAMINE 
command. 


SET SYMBOLIZE {ON|OFF} 


Enables symbolization of addresses. 


OFF 
Disables symbolization of addresses. 


None. 


SDA> SET SYMBOLIZE ON 
SDA> examine g1234 
SYSSPUBLIC_VECTORS+01234: 47DF041C "..8G" 


SDA> SET SYMBOLIZE OFF 
SDA> examine g1234 
FFFFFFFF.80001234: 47DF041C "..BG" 


These examples show the effect of enabling (default) or disabling 
symbolization of addresses. 
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SHOW ADDRESS 


Format 


Parameter 


Qualifier 


Description 


Examples 


Displays the page table related information about a memory address. 


SHOW ADDRESS address [/PHYSICAL] 


address 
The requested address. 


/PHYSICAL 
Indicates that a physical address has been given. The SHOW ADDRESS 
command displays the virtual address that maps to the given physical address. 


The SHOW ADDRESS command displays the region of memory that contains the 
memory address. It also shows all the page table entries (PTEs) that map the 
page and can show the range of addresses mapped by the given address if it is the 
address of a PTE. If the virtual address is in physical memory, the corresponding 
physical address is displayed. 


When the /PHYSICAL qualifier is given, the SHOW ADDRESS command displays 
the virtual address that maps to the given physical address. This provides you 
with a way to use SDA commands that do not have a /PHYSICAL qualifier when 
only the physical address of a memory location is known. 


1. SDA> SHOW ADDRESS 80000000 
FFFFFFFF.80000000 is an S0/S1 address 


Mapped by Level-3 PTE at: FFFFFFFD.FFE00000 
Mapped by Level-2 PTE at: FFFFFFFD.FF7FF800 
Mapped by Level-1 PTE at: FFFFFFFD.FF7FDFF8 
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0 


Also mapped in SPT window at: FFFFFFFF.FFDF0000 
Mapped to physical address 00000000.00400000 


The SHOW ADDRESS command in this example shows where the address 
80000000 is mapped at different page table entry levels. 


2. SDA> SHOW ADDRESS 0 
00000000.00000000 is a PO address 


Mapped by Level-3 PTE at: FFFFFFFC.00000000 
Mapped by Level-2 PTE at: FFFFFFFD.FF000000 
Mapped by Level-1 PTE at: FFFFFFFD.FF7FC000 
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0 


Not mapped to a physical address 
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The SHOW ADDRESS command in this example shows where the address 0 is 
mapped at different page table entry levels. 


SDA> SHOW ADDRESS FFFFFFFD.FF000000 
FFFFFFFD.FF000000 is the address of a process-private Level-2 PTE 


Mapped by Level-1 PTE at: FFFFFFFD.FF7FC000 
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0 


Range mapped at level 2: FFFFFFFC.00000000 to FFFFFFFC.00001FFF (1 page) 
Range mapped at level 3: 00000000.00000000 to 00000000.007FFFFF (1024 pages) 


Mapped to physical address 00000000.01230000 


The SHOW ADDRESS command in this example shows where the address 
FFFFFFFD.FF7FC000 is mapped at page table entry and the range mapped by 
the PTE at this address. 


SDA> SHOW ADDRESS/PHYSICAL 0 
Physical address 00000000.00000000 is mapped to system-space address FFFFFFFF.828FC000 


The SHOW ADDRESS command in this example shows physical address 
00000000.00000000 mapped to system-space address FFFFFFFF.828FC000. 


SDA> SHOW ADDRESS/PHYSICAL 029A6000 


Physical address 00000000.029A6000 is mapped to process-space address 00000000.00030000 
(process index 0024) 


The SHOW ADDRESS command in this example shows physical address 
00000000.029A6000 mapped to process-space address 00000000.00030000 
(process index 0024). 
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SHOW BUGCHECK 


Displays the value, name, and text associated with one or all bugcheck codes. 


Format 
SHOW BUGCHECK  {/ALL (d)|name| number} 


Parameters 
name 
The name of the requested bugcheck code. 


number 
The value of the requested bugcheck code. The severity bits in the value are 
ignored. 


The parameters name and number and the qualifier /ALL are all mutually 
exclusive. 


Qualifier 


/ALL 
Displays complete list of all the bugcheck codes, giving their value, name, and 
text. It is the default. 


Description 


The SHOW BUGCHECK command displays the value, name, and text associated 
with bugcheck codes. 


Examples 
1. SDA> SHOW BUGCHECK 104 
0100 DIRENTRY ACP failed to find same directory entry 


The SHOW BUGCHECK command in this example shows the requested 
bugcheck by number, ignoring the severity (FATAL). 


2. SDA> SHOW BUGCHECK DECNET 
08D0 DECNET DECnet detected a fatal error 


The SHOW BUGCHECK command in this example shows the requested 
bugcheck by name. 


3. SDA> SHOW BUGCHECK 
BUGCHECK codes and texts 


0008 ACPMBFAIL ACP failure to read mailbox 

0010 ACPVAFAIL ACP failure to return virtual address space 
0018 ALCPHD Allocate process header error 

0020 ALCSMBCLR ACP tried to allocate space already allocated 


The SHOW BUGCHECK command in this example shows the requested 
bugcheck by displaying all codes. 
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SHOW CALL_FRAME 


Format 


Parameter 


Qualifiers 


Description 


Displays the locations and contents of the quadwords representing a procedure 
call frame. 


SHOW CALL_FRAME__ {[starting-address] |/EXCEPTION_FRAME=intstk_address 
|/NEXT_FRAME1/SUMMARY |/ALL} 


starting-address 

For Alpha, an expression representing the starting address of the procedure call 
frame to be displayed. The default starting-address is the contents of the FP 
(frame) register of the SDA current process. 


For 164, the address is the invocation context handle of the frame, and the default 
is the handle of the current procedure. 


/ALL 

Displays details of all call frames beginning at the current frame and continuing 
until bottom of stack (equivalent to SHOW CALL and repeated execution of a 
SHOW CALL/NEXT command). 


/EXCEPTION_FRAME=intstk_address 

(164 only.) Provides an alternate starting address for SHOW CALL_FRAME. 
intstk_address is the address of an exception frame from which SDA creates an 
initial invocation context and displays the procedure call frame. 


/NEXT_FRAME 

Displays the procedure call frame starting at the address stored in the frame 
longword of the last call frame displayed by this command. You must have issued 
a SHOW CALL_FRAME command previously in the current SDA session in order 
to use the /NEXT_FRAME qualifier to the command. 


/SUMMARY 

Provides a one-line summary for each call frame, including exception frames, 
system-service entry frames, ASTs, KPBs, and so on, until reaching the bottom of 
the stack. 


Whenever a procedure is called, information is stored on the stack of the calling 
routine in the form of a procedure call frame. The SHOW CALL_FRAME 
command displays the locations and contents of the call frame. The starting 
address of the call frame is determined from the specified starting address, the 
/NEXT_FRAME qualifier, or the address contained in the SDA current process 
frame register (the default action). 
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SHOW CALL_FRAME 


Examples 


When using the SHOW CALL_FRAME/NEXT_FRAME command to follow a 
chain of call frames, SDA signals the end of the chain by the following message: 


Cannot display further call frames (bottom of stack) 


This message indicates that the saved frame in the previous call frame has a zero 
value (Alpha) or that the current frame is marked “Bottom of Stack” (164). 


1. SDA> SHOW CALL FRAME 
Call Frame Information 


Stack Frame Procedure Descriptor 

Base Register = FP, No Jacket, Native 

Procedure Entry: FFFFFFFF.837E9F10 EXCEPTION PRO+01F10 
Return address on stack = FFFFFFFF.837E8A1C EXESCONTSIGNAL C+0019C 


Registers saved on stack 


TFFI5F98 
7FF95FA0 
7FF95FA8 
7FF95FBO 
7FF95FB8 


FFFFFFFF.FFFFFFFB Saved R2 

FFFFFFFF.8042AEA0 Saved R3 EXCEPTION NPRW+040A0 
00000000.00000002 Saved R5 ~ 
FFFFFFFF.804344A0 Saved R13 SCHSCLREF+00188 
00000000.7FF9FC00 Saved R29 


SDA> SHOW CALL _FRAME/NEXT FRAME 
Call Frame Information 


Register 
TFF99F60 
TFF99F68 
TFF99F70 
TFF99F78 
TFF99F80 
TFF99F88 
TFF99F90 
TFF99F98 
7FF99FAO 
7FF99FA8 
7FF99FBO 
7FF99FB8 


SDA> SHO 
Call Fra 


Register 
7FF9FD88 
7FF9FD90 
7FF9FD98 
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Stack Frame Procedure Descriptor 

Base Register = FP, No Jacket, Native 

Procedure Entry: FFFFFFFF.800FA388 RMS NPRO+04388 
Return address on stack = FFFFFFFF.80040BFC EXCEPTION _NPRO+00BFC 


s saved on stack 
FFFFFFFF.FFFFFFFD Saved R2 
FFFFFFFF.80425BA0 Saved R3 EXCEPTION NPRW+03DA0 
FFFFFFFF.80422020 Saved R4 EXCEPTION NPRW+00220 
00000000.00000000 Saved R5 ~ 
FFFFFFFF.835C24A8 Saved R6 RMS PRO+004A8 
00000000.7FF99FCO Saved R7 ~ 
00000000.7FF9FDE8 Saved R8 
00000000.7FF9FDFO0 Saved R9 
00000000.7FF9FE78 Saved R10 
00000000.7FF9FEBC Saved R11 
FFFFFFFF.837626E0 Saved R13 EXESOPEN MESSAGE+00088 
00000000.7FF9FD70 Saved R29 7 


W CALL FRAME/NEXT FRAME 

me Information —~ 

Stack Frame Procedure Descriptor 

Base Register = FP, No Jacket, Native 

Procedure Entry: FFFFFFFF.835C2438 RMS_PRO+00438 

Return address on stack = FFFFFFFF.83766020 EXESOPEN_MESSAGE_C+00740 


s saved on stack 


00000000.7FF9FDA4 Saved R2 
00000000.7FF9FF00 Saved R3 
00000000.7FFA0050 Saved R29 
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The SHOW CALL_FRAME commands in this SDA session follow a chain of call 
frames from that specified in the frame of the SDA current process. 


SDA> SHOW CALL/SUMMARY 
Call Frame Summary 


Exception Dispatcher 00000000. 7FF43EB0 
Register Stack Frame 00000000.7FF12180 
Memory Stack Frame 00000000.7FF43ED0 
Memory Stack Frame 00000000.7FF43F20 


SS Dispatcher 00000000. 3FFFDFCO 
Register Stack Frame 000007FD.BFF58000 
KP Start Frame 00000000. 7AC95A20 


Memory Stack Frame 00000000.7AC95B50 
Memory Stack Frame 00000000.7AC95BC0 
Base Frame 00000000. 7AC95BE0 
Bottom of stack 


Current PC 


FFFFFFFF. 
00000000. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
00000000. 
FFFFFFFF. 
00000000. 
00000000. 
00000000. 


8049E160 
000122Cc0 
8066B440 
80194890 
8018D240 
000124c0 
80161670 
00012CE0 
000126F0 
7ADEOBBO 


EXCEPTION MON+5E360 

KP SAMPLE+122C0 

EXESCMKRNL C+00330 
EXES$SS_DISP_C+00400 

SWISSENTER KERNEL SERVICE C+003E0 
KP SAMPLE+124c0 ~ ~ 
EXESKP START C+003C0 

KP SAMPLE+12CE0 

KP SAMPLE+126F0 

DCL+82BB0 


This example of SHOW CALL/SUMMARY on an I64 system shows the call frame 
summary of a process that has triggered an exception. The exception occurred 
while running a program called KP_SAMPLE which has invoked the $CMKRNL 


system service. 
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SHOW CBB 


Displays contents of a Common Bitmask Block. 


Format 
SHOW CBB address 
Parameters 
address 
The address of the Common Bitmask Block. This is required. 
Qualifiers 
None. 
Description 
The contents of the specified common bitmask block are displayed: the number 
of valid bits, the interlock state, the unit size and count, and the current settings 
for the bits in the bitmask. 
Example 


SDA> SHOW CBB SMP$GS_CBB ACTIVE SET 
Common Bitmask Block at FFFFFFFF.8180CA00 


Valid bits: 00000040 State: 00000000.00000000 
Unit count: 0001 Unit size: QUADWORD 


Unit bitmask: 
Ciielaade, Gememmars 00000000 00000001 00000000 


This example shows the active-CPU common bitmask block for a single-CPU 
system. 
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SHOW CEB 


Format 


Parameters 


Qualifiers 


Description 


Examples 


1. SDA> SHOW CEB 


Displays information about Common Event flag Blocks, also known as Common 
Event flag clusters. 


SHOW CEB. [address 1/ALL] 


address 
The address of a common event flag block. Detailed information is displayed for 
the specified common event flag block. 


/ALL 
Specifies that detailed information is to be displayed for each common event flag 
block. By default, a one-line summary is output for each common event flag block. 


The contents of one or all common event flag blocks is displayed. In one-line 
summary format, the address, name, creator process, reference count, current 
settings for the 32 event flags in the cluster, and the UIC of the cluster are 
displayed. In detailed format, the address of the cluster’s Object Rights Block 
(ORB) and the count of waiting threads are also displayed, with lists of all 
associated processes and waiting threads. 


You cannot specify both an address and /ALL; they are mutually exclusive. 


SHOW COMMON_EVENT_BLOCK is a synonym for SHOW CEB. 


Common Event Flags 


Address Name Creator RefCount EvtFlags UIC Flags 
81E1D340 clus6 0000009B Testl 00000001 00000000 [11,1] Permanent 
81E294C0 clus5 0000009B Test2 00000001 00000000 [11,1] Permanent 
8213A280 IPCACP_ FLAGS 00000086 IPCACP 00000001 00000000 [1,*] 


This example shows the one-line summary of all common event flag blocks. 
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2. SDA> SHOW CEB 81E294C0 
Common Event Flags 


CEB Address: 81E294C0 Name: clus5 
Creator process EPID: 0000009B Name: Test2 
Event flag vector: 00000000 Reference count: 00000001 
ORB address: 829F75B0 Wait count: 00000001 
UIC: [11,1] Flags: 00000002 Permanent 
Associated Processes Waiting Threads 
PCB EPID Name KTB Indx WaitMask 
81E1C740 000000A4 BISHOP 47 81E1C740 0000 FFFFFF84 


This example shows the details for the CEB at the given address. 
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SHOW CLUSTER 


Format 


Parameters 


Qualifiers 


Description 


Displays connection manager and system communications services (SCS) 
information for all nodes in a cluster. 


SHOW CLUSTER § {[{/ADDRESS=n|/CS|ID=csid|/NODE=name}] |/SCS} 


None. 


/ADDRESS=n 

Displays only the OpenVMS Cluster system information for a specific OpenVMS 
Cluster member node, given the address of the cluster system block (CSB) for 
the node. This is mutually exclusive with the /CSID=csid and /NODE=name 
qualifiers. 


/CSID=csid 

Displays only the OpenVMS Cluster system information for a specific OpenVMS 
Cluster member node. The value csid is the cluster system identification number 
(CSID) of the node to be displayed. You can find the CSID for a specific node in 
a cluster by examining the CSB list display of the SHOW CLUSTER command. 
Other SDA displays refer to a system’s CSID. For instance, the SHOW LOCKS 
command indicates where a lock is mastered or held by CSID. This is mutually 
exclusive with the /ADDRESS=n and /NODE=name qualifiers. 


/NODE=name 

Displays only the OpenVMS Cluster system information for a specific OpenVMS 
Cluster member node, given its SCS node name. This is mutually exclusive with 
the /ADDRESS=n and /CSID=csid qualifiers. 


/scs 
Displays a view of the cluster as seen by SCS. 


The SHOW CLUSTER command provides a view of the OpenVMS Cluster system 
from either the perspective of the connection manager (the default behavior), or 
from the perspective of the port driver or drivers (if the /SCS qualifier is used). 


OpenVMS Cluster as Seen by the Connection Manager 
The SHOW CLUSTER command provides a series of displays. 


The OpenVMS Cluster summary display supplies the following information: 
e Number of votes required for a quorum 

e Number of votes currently available 

e Number of votes allocated to the quorum disk 


e Status summary indicating whether or not a quorum is present 
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The CSB list displays information about the OpenVMS Cluster system blocks 
(CSBs) currently in operation; one CSB is assigned to each node of the cluster. 
For each CSB, the CSB list displays the following information: 


e Address of the CSB 

e Name of the OpenVMS Cluster node it describes 
e CSID associated with the node 

e Number of votes (if any) provided by the node 

e State of the CSB 

e Status of the CSB 


For information about the state and status of nodes, see the description of the 
ADD CLUSTER command of the SHOW CLUSTER utility in the HP OpenVMS 
System Management Utilities Reference Manual. 


The cluster block display includes information recorded in the cluster block 
(CLUB), including a list of activated flags, a summary of quorum and vote 
information, and other data that applies to the cluster from the perspective of the 
node for which the SDA is being run. 


The cluster failover control block display provides detailed information 
concerning the cluster failover control block (CLUFCB). The cluster quorum 
disk control block display provides detailed information from the cluster 
quorum disk control block (CLUDCB). 


Subsequent displays provide information for each CSB listed previously in the 
CSB list display. Each display shows the state and flags of a CSB, as well as 
other specific node information. (See the ADD MEMBER command of the SHOW 
CLUSTER utility in the HP OpenVMS System Management Utilities Reference 
Manual for information about the flags for OpenVMS Cluster nodes.) 


If any of the qualifiers /ADDRESS=n, /CSID=csid, or /NODE=name are specified, 
then the SHOW CLUSTER command displays only the information from the CSB 
of the specified node. 


OpenVMS Cluster as Seen by the Port Driver 
The SHOW CLUSTER/SCS command provides a series of displays. 


The SCS listening process directory lists those processes that are listening for 
incoming SCS connect requests. For each of these processes, this display records 
the following information: 


e Address of its directory entry 

e Connection ID 

e Name 

e Explanatory information, if available 


The SCS systems summary display provides the system block (SB) address, 
node name, system type, system ID, and the number of connection paths for 
each SCS system. An SCS system can be a OpenVMS Cluster member, storage 
controller, or other such device. 


4-74 SDA Commands 


SDA Commands 
SHOW CLUSTER 


Subsequent displays provide detailed information for each of the system blocks 
and the associated path blocks. The system block displays include the maximum 
message and datagram sizes, local hardware and software data, and SCS 
poller information. Path block displays include information that describes the 
connection, including remote functions and other path-related data. 


Examples 


1. SDA> SHOW CLUSTER 
OpenVMS Cluster data structures 


--- OpenVMS Cluster Summary --- 


Quorum Votes Quorum Disk Votes Status Summary 


2 2 1 qf_dynvote,qf_ vote, quorum 
--- CSB list --- 
Address Node CSID Votes State Status 
805FA780 FLAM5 00010006 0 local member,qf same,qf noaccess 
8062C400 ROMRDR 000100ED 1 open member, qf same,qf watcher,qf active 
8062C780 VANDO1 000100EF 0 open member ,qf same,qf noaccess 


--- Cluster Block (CLUB) 805FA380 --- 
Flags: 16080005 cluster,qf dynvote,init,qf vote,qf newvote, quorum 


Quorum/Votes 2/2 Last transaction code 02 
Quorum Disk Votes 1 Last trans. number 596 
Nodes 3 Last coordinator CSID 000100EF 
Quorum Disk S$1SDIA0 Last time stamp 31-DEC-1992 
Found Node SYSID 00000000FC03 17:26:35 
Founding Time 3-JAN-1993 Largest trans. id 00000254 

21:04:21 Resource Alloc. retry 0 
Index of next CSID 0007 Figure of Merit 00000000 
Quorum Disk Cntrl Block 805FADCO Member State Seq. Num 0203 
Timer Entry Address 00000000 Foreign Cluster 00000000 
CSP Queue empty 


--- Cluster Failover Control Block (CLUFCB) 805FA4C0 --- 
Flags: 00000000 


Failover Step Index 00000037 CSB of Synchr. System 8062C780 
Failover Instance ID 00000254 


--- Cluster Quorum Disk Control Block (CLUDCB) 805FADCO --- 


State : 0002 qs rem act 

Flags : 0100 qf noaccess 

CSP Flags : 0000 

Iteration Counter 0 UCB address 00000000 
Activity Counter 0 TQE address 805FAE00 
Quorum file LBN 00000000 IRP address 00000000 


Watcher CSID 000100ED 
--- FLAM5 Cluster System Block (CSB) 805FA780 --- 


State: 0B local 

Flags: 070260AA member,qf same,qf noaccess,selected,local,status rcvd,send_ status 
Cpblty: 00000000 

sWVers: 7.0 

HWName: DEC 3000 Model 400 
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Quorum/Votes 1/0 Next seq. number 0000 Send queue 00000000 
Quor. Disk Vote 1 Last seq num rcvd 0000 Resend queue 00000000 
CSID 00010006 Last ack. seq num 0000 Block xfer Q. 805FA7D8 
Eco/Version 0/23 Unacked messages 0 CDT address 00000000 
Reconn. time 00000000 Ack limit 0 PDT address 00000000 
Ref. count 2 Incarnation  1-JAN-1993 TQE address 00000000 
Ref. time 31-AUG-1992 00:00:00 SB address 80421580 

17:26:35 Lock mgr dir wgt 0 Current CDRP 00000001 


--- ROMRDR Cluster System Block (CSB) 8062C400 --- 


State: 01 open 

Flags: 0202039A member,qf same,cluster,qf_active,selected,status_rcevd 
Cpblty: 00000000 ~ = 

sWVvers: 7.0 

HWName: DEC 3000 Model 400 


Quorum/Votes 2/1 Next seq. number B350 Send queue 00000000 
Quor. Disk Vote 1 Last seq num rcvd E786 Resend queue 00000000 
CSID 000100ED Last ack. seq num  B350 Block xfer Q. 8062C458 
Eco/Version 0/22 Unacked messages 1 CDT address 805E8870 
Reconn. time 00000000 Ack limit 3 PDT address 80618400 
Ref. count 2 Incarnation 19-AUG-1992 TQE address 00000000 
Ref. time 19-AUG-1992 16:15:00 SB address 8062C140 

16:17:08 Lock mgr dir wgt 0 Current CDRP 00000000 


--- VANDQ1 Cluster System Block (CSB) 8062C780 --- 


State: 01 open 
Flags: 020261AA member,qf same,qf noaccess,cluster,selected,status revd 
Cpblty: 00000000 


SWVers: 7.0 

HWName: DEC 3000 Model 400 

Quorum/Votes 1/0 Next seq. number 32B6 Send queue 00000000 
Quor. Disk Vote 1 Last seq num rcvd A908 Resend queue 00000000 
CSID 000100EF Last ack. seq num 32B6 Block xfer Q. 8062C7D8 
Eco/Version 0/23 Unacked messages 1 CDT address 805E8710 
Reconn. time 00000000 Ack limit 3 PDT address 80618400 
Ref. count 2 Incarnation 17-AUG-1992 TQE address 00000000 
Ref. time 19-AUG-1992 15:37:06 SB address 8062BCC0 


16:21:22 Lock mgr dir wgt 0 Current CDRP 00000000 


--- SWPCTX Cluster System Block (CSB) 80D3B1C0 --- 


State: 0B local 
Flags: 030A60AA member,qf same,qf noaccess,selected,send_ext_status,local,status_rcvd 
Cpblty: 00000037 rm8sec,vcc,dts,cwcreprc, threads 


SWVers: V7.0 

HWName: DEC 3000 Model 400 

Quorum/Votes 1/1 Next seq. number 0000 Send queue 00000000 
Quor. Disk Vote 1 Last seq num rcvd 0000 Resend queue 00000000 
CSID 00010001 Last ack. seq num 0000 Block xfer Q. 80D3B218 
Eco/Version 0/26 Unacked messages 0 CDT address 00000000 
Reconn. time 00000000 Ack limit 0 PDT address 00000000 
Ref. count 2 Incarnation 12-JUL-1996 TQE address 00000000 
Ref. time 16-JUL-1996 15:36:17 SB address 80C50800 


16:15:48 Lock mgr dir wgt 0 Current CDRP 00000001 
This example illustrates the default output of the SHOW CLUSTER command. 
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SHOW CLUSTER 
2. SDA> SHOW CLUSTER/SCS 
OpenVMS Cluster data structures 
--- SCS Listening Process Directory --- 

Entry Address Connection ID Process Name Information 
80C71EC0 74D20000 SCSSDIRECTORY Directory Server 
80C72100 74D20001 MSCPSTAPE NOT PRESENT HERE 
80E16940 74D20002 MSCPSDISK MSCPSDISK 
80E23B40 74D20003 VMSSSDA AXP Remote SDA 
80E23B40 74D20003 VMSSSDA AXP Remote SDA 
80E25540 74D20004 VMSSVAXCluster hence eeeeeeee 
80E29E80 74D20005 SCASTRANSPORT 
813020C0 74D20053 PATHWORKScluster ~~ ..... TurboServer 

--- SCS Systems Summary --- 
SB Address Node Type System ID Paths 
8493BC00 ARUSHA VMS 000000004CA1 2 
80E23800 HSJ201 HSJ 4200101A1B20 1 
80E3FF40 ORNOT VMS 000000004CA7 2 
80E43F40 LOADQ VMS 000000004C31 2 
80E473C0 HSJ300 HSJ 420010051D20 1 
80E47CC0 HSJ101 HSJ 420010081720 1 
80E47D40 HSJ100 HSJ 4200100B1520 1 
80E478C0 HSJ600 HSJ 420010070920 1 
80E49180 HSJ401 HSJ 4200100D0320 1 
80E47DC0 HSJ301 HSJ 420010091F20 1 
80E47E40 HSJ601 HSJ 4200100A0B20 1 
80E49500 HSJ400 HSJ 4200100C0120 1 
80E5BF80 CHOBE VMS 000000004CD6 2 
80E5F080 ETOSHA VMS 000000004CF3 2 
80E5FC00 VMS VMS 000000004C7A 2 
80E4FF80 HSJ501 HSJ 420010100720 1 
80E5FD80 HSJ200 HSJ 420010191920 1 
80E5FE80 HSJ500 HSJ 4200101B0520 1 
80E5FE00 IPL31 VMS 000000004F52 2 
80E59F80 ZAPNOT VMS 000000004CBB 2 
80E61F80 ALTOS VMS 000000004D0F 2 
80E72000 TSAVO VMS 000000004CFE 2 
80ED5D00 SLYTHE VMS 000000004DD1 1 
80EDDD00 AZSUN VMS 000000004D56 1 
80EDDE00 CALSUN VMS 000000004EA4 1 
80EDFC00 4Xx4TRK VMS 00000000FF26 1 
80EE93C0 GNRS VMS 00000000FC2B 1 
80EE94C0 IXIVIV VMS 000000004E56 1 
80EF1A80 CLAIR VMS 000000004CDF 1 
80EF1C00 INT4 VMS 00000000FD70 1 
80EFDF80 SCOP VMS 00000000FC87 1 
80EFFACO MOCKUP VMS 00000000FCD5 1 
--- ARUSHA System Block (SB) 8493BC00 --- 

System ID 000000004CA1 Local software type VMS 

Max message size 216 Local software vers. V7.2 

Max datagram size 576 Local software incarn. DF4AC300 

Local hardware type ALPH 009F7570 

Local hardware vers. 000000000003 SCS poller timeout 5AD3 

040400000000 SCS poller enable mask 27 


Status: 00000000 
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--- Path Block (PB) 80E55F80 --- 
Status: 0020 credit 


Remote sta. addr. 000000000016 Remote port type 00000010 
Remote state ENAB Number of data paths 2 
Remote hardware rev. 00000008 Cables state A-OK B-OK 

Remote func. mask ABFFOD00 Local state OPEN 
Reseting port 16 Port dev. name PNAO 

Handshake retry cnt. 2 SCS MSGBUF address 80E4C528 
Msg. buf. wait queue 80E55FB8 PDT address 80E2A180 


--- Path Block (PB) 80ED0900 --- 
Status: 0020 credit 


Remote sta. addr. 0000000000DF Remote port type NI 
Remote state ENAB Number of data paths 2 
Remote hardware rev. 00000104 Cables state A-OK B-OK 

Remote func. mask 83FF0180 Local state OPEN 
Reseting port 00 Port dev. name PEAO 

Handshake retry cnt. 3 SCS MSGBUF address 80ED19A0 
Msg. buf. wait queue 80ED0938 PDT address 80EC3C70 


This example illustrates the output of the SHOW CLUSTER /SCS command. 
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SHOW CONNECTIONS 


Format 


Parameters 


Qualifiers 


Description 


Displays information about all active connections between System 
Communications Services (SCS) processes or a single connection. 


SHOW CONNECTIONS = [{/ADDRESS=cat-address | /NODE=name|/SYSAP=name}] 


None. 


/ADDRESS=cdt-address 

Displays information contained in the connection descriptor table (CDT) for a 
specific connection. You can find the cdt-address for any active connection on 

the system in the CDT summary page display of the SHOW CONNECTIONS 
command. In addition, CDT addresses are stored in many individual data 
structures related to SCS connections. These data structures include class driver 
request packets (CDRPs) and unit control blocks (UCBs) for class drivers that use 
SCS, and cluster system blocks (CSBs) for the connection manager. 


/NODE=name 
Displays all CDTs associated with the specified remote SCS node name. 


/SYSAP=name 
Displays all CDTs associated with the specified local SYSAP. 


The SHOW CONNECTIONS command provides a series of displays. 


The CDT summary page lists information regarding each connection on the 
local system, including the following: 


e CDT address 

e Name of the local process with which the CDT is associated 

e Connection ID 

e Current state 

e Name of the remote node (if any) to which it is currently connected 


The CDT summary page concludes with a count of CDTs that are free and 
available to the system. 


SHOW CONNECTIONS next displays a page of detailed information for each 
active CDT listed previously. 
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Example 


SDA> SHOW CONNECTIONS 


CDT Address 


805E7EDO 
805E8030 
805E8190 
805E82F0 
805E8450 
805E85B0 
805E8710 
805E8870 
805E89D0 
805E8C90 
805E8DF0 
805E8F50 


--- CDT Summary Page --- 


Number of free CDT’s: 


Local Process Connection ID State Remote Node 
SCSSDIRECTORY FF120000 listen 

MSCPSTAPE FF120001 listen 
VMSSVMScluster FF120002 listen 

MSCPSDISK FF120003 listen 
SCASTRANSPORT FF120004 listen 

MSCPSDISK FF150005 open VANDQ1 
VMSSVMScluster FF120006 open VANDQ1 
VMSSVMScluster FF120007 open ROMRDR 
MSCPSDISK FF120008 open ROMRDR 
VMS$DISK_CL_DRVR FF12000A open ROMRDR 
VMS$DISK_CL_DRVR FF12000B open VANDQ1 
VMS$TAPE_CL_DRVR FF12000C open VANDQ1 

188 
--- Connection Descriptor Table (CDT) 80C44850 --- 
Local Process: MSCPSTAPE 


State: 


Blocked State: 


Local Con. 
Remote Con. 


0001 listen 


0000 
899F000 


ID 00000000 


Receive Credit 


Send Credit 


Min. Rec. Credit 
Pend Rec. Credit 
Initial Rec. Credit 


Rem. Sta. 


00000000000 


Rej/Disconn Reason 
Queued for BDLT 
Queued Send Credit 


0 
0 
0 
0 
0 Send Data Init. 
0 
0 
0 


3 Datagrams sent 
Datagrams rcvd 


0 Datagram discard 


Message Sends 
Message Recvs 
Mess Sends NoFP 
Mess Recvs NoFP 


Reg Data Init. 
Bytes Sent 
Bytes revd 
Total bytes map 


ooooocoonooocoo 


Message queue 
Send Credit Q. 
PB address 

PDT address 
Error Notify 
Receive Buffer 
Connect Data 
Aux. Structure 
Fast Recvmsg Rq 
Fast Recvmsg PM 
Change Affinity 


--- Connection Descriptor Table (CDT) 805E8030 --- 
MSCPSTAPE 


State: 


Blocked State: 


Local Con. 
Remote Con. 


0001 listen 


0000 
FF12000 


ID 00000000 


Receive Credit 


Send Credit 


Min. Rec. Credit 
Pend Rec. Credit 
Initial Rec. Credit 


Rem. Sta. 


00000000000 


Rej/Disconn Reason 
Queued for BDLT 
Queued Send Credit 


0 
0 
0 
0 
0 Bytes Sent 
0 
0 
0 


Local Process: 


1 Datagrams sent 
Datagrams rcvd 


0 Datagram discard 


Messages Sent 

Messages Rcvd. 
Send Data Init. 
Req Data Init. 


Bytes revd 
Total bytes map 


oooon”nooc”joocoo 


Message queue 
Send Credit Q. 
PB address 

PDT address 
Error Notify 
Receive Buffer 
Connect Data 
Aux. Structure 


80C4488C 
80044894 
00000000 
00000000 
822FFCC0 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


805E8060 
805E8068 
00000000 
00000000 
804540D0 
00000000 
00000000 
00000000 


This example shows the default output of the SHOW CONNECTIONS command. 
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SHOW CPU 


Format 


Parameter 


Qualifiers 


Description 


When analyzing a dump, displays information about the state of a CPU at the 
time of the system failure. 


SHOW CPU is only valid when you are analyzing a crash dump. It is not a valid 
command when you are analyzing the running system, because all the CPU- 
specific information may not be available. If invoked when you are analyzing a 
running system, SHOW CPU will only list the CPU database address(es) for the 
specified CPU or all CPUs. 


SHOW CPU _[cpu-id] 


cpu-id 

Numeric value from 00 to 1F jg indicating the identity of the CPU for which 
context information is to be displayed. If you specify a value outside this range, 
or you specify the cpu-id of a CPU that was not active at the time of the system 
failure, SDA displays the following message: 


%SDA-E-CPUNOTVLD, CPU not booted or CPU number out of range 


If you use the cpu-id parameter, the SHOW CPU command performs an implicit 
SET CPU command, making the CPU indicated by cpu-id the current CPU for 
subsequent SDA commands. (See the description of the SET CPU command and 
Section 2.5 for information on how this can affect the CPU context—and process 
context—in which SDA commands execute.) 


None. 


The SHOW CPU command displays system failure information about the CPU 
specified by cpu-id or, by default, the SDA current CPU, as defined in Section 2.5. 


The SHOW CPU command produces several displays. The first display is a brief 
description of the system failure and its environment that includes the following: 


e Reason for the bugcheck. 


e Name of the currently executing process. If no process has been scheduled on 
this CPU, SDA displays the following message: 


Process currently executing: no processes currently scheduled on the processor 


e File specification of the image executing within the current process (if there is 
a current process). 


e Interrupt priority level (IPL) of the CPU at the time of the system failure. 
e The CPU database address. 
e The CPU’s capability set. 
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On Alpha, the register display follows. First the general registers are output, 
showing the contents of the CPU’s integer registers (RO to R30), and the AI, RA, 
PV, FP, PC, and PS at the time of the system failure. 


The Alpha processor registers display consists of the following parts: 
e Common processor registers 

e Processor-specific registers 

e Stack pointers 


The first part of the processor registers display includes registers common to all 
Alpha processors, which are used by the operating system to maintain the current 
process virtual address space, system space, or other system functions. This part 
of the display includes the following registers: 


e Hardware privileged context block base register (PCBB) 
e System control block base register (SCBB) 

e Software interrupt summary register (SISR) 

e Address space number register (ASN) 

e AST summary register (ASTSR) 

e AST enable register (ASTEN) 

e Interrupt priority level register (IPL) 

e Processor priority level register (PRBR) 

e Page table base register (PTBR) 

e Virtual page table base register (VPTB) 

e Floating-point control register (FPCR) 

e Machine check error summary register (MCES) 


On 164, the register display is in the form of the contents of the exception frame 
generated by the bugcheck. See SHOW CRASH for more details. 


The last part of the display includes the four stack pointers: the pointers of 
the kernel, executive, supervisor, and user stacks (KSP, ESP, SSP, and USP, 
respectively). In addition, on 164, the four register stack pointers are displayed: 
KBSP, EBSP, SBSP, UBSP. 


The SHOW CPU command concludes with a listing of the spinlocks, if any, owned 
by the CPU at the time of the system failure, reproducing some of the information 
given by the SHOW SPINLOCKS command. The spinlock display includes the 
following information: 


e Name of the spinlock. 

e Address of the spinlock data structure (SPL). 
e The owning CPU’s CPU ID. 

e IPL of the spinlock. 


e Indication of the depth of this CPU’s ownership of the spinlock. A number 
greater than 1 indicates that this CPU has nested acquisitions of the spinlock. 


e Rank of the spinlock. 


e Timeout interval for spinlock acquisition (in terms of 10 milliseconds). 
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e Shared array (shared spinlock context block pointers) 


Example 


SDA> SHOW CPU 0 
CPU 00 Processor crash information 


CPU 00 reason for Bugcheck: CPUEXIT, Shutdown requested by another CPU 
Process currently executing on this CPU: None 

Current IPL: 31 (decimal) 

CPU database address: 81414000 

CPUs Capabilities: PRIMARY , QUORUM, RUN 


General registers: 


RO = FFFFFFFF.81414000 Rl = FFFFFFFF.81414000 R2 = 00000000.00000000 
R3 = FFFFFFFF.810AD960 R4 = 00000000.01668E90 R5 = 00000000.00000001 
R6 = 66666666.66666666 R7 = 77777777.77777777 R&8 = FFFFFFFF.814FB040 
R9 = 99999999.99999999 R10 = FFFFFFFF.814FB0C0 R11 = BBBBBBBB.BBBBBBBB 
R12 = cccccccc.cccccccc R13 = FFFFFFFF.810AD960 R14 = FFFFFFFF.81414018 
R15 = 00000000.00000004 R16 = 00000000.000006AC R17 = 00000000.00000047 
R18 = 00000000.00000000 R19 = 00000000.00000000 R20 = FFFFFFFF.8051A494 
R21 = 00000000.00000000 R22 = 00000000.00000001 R23 = 00000000.00000010 
R24 = FFFFFFFF.81414000 AI = FFFFFFFF.81414000 RA = FFFFFFFF.81006000 
PV = 00000001.FFFFFFFF R28 = 00000000.00000000 FP = FFFFFFFF.88ABDFD0 
PC = FFFFFFFF.8009C95C PS = 18000000.00001F04 


Processor Internal Registers: 


ASN = 00000000.00000000 ASTSR/ASTEN = 00000000 
IPL = 0000001F PCBB = 00000000.01014080 PRBR = FFFFFFFF.81414000 
PTBR = 00000000.0000FFBF SCBB = 00000000.000001E8 SISR = 00000000.00000100 
VPTB = FFFFFEFC.00000000 FPCR = 00000000.00000000 MCES = 00000000.00000000 

KSP = FFFFFFFF.88ABDCD8 

ESP = FFFFFFFF. 88ABF000 

SSP = FFFFFFFF.88AB9000 

USP = FFFFFFFF.88AB9000 

Spinlocks currently owned by CPU 00 

SCS Address 810AF300 
Owner CPU ID 00000000 IPL 00000008 
Ownership Depth 00000000 Rank 0000001A 
Timeout Interval 002DC6C0 Share Array 00000000 
This example shows the default output of the SHOW CPU command on an Alpha 
system. 
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SHOW CRASH 


Displays information about the state of the system at the time of failure. Provides 
system information identifying a running system and can display exception 


information. 
Format 
SHOW CRASH _ [/CPU=n] 
Parameters 
None. 
Qualifier 
/CPU=n 
Allows exception data to be displayed from CPUs other than the one considered 
as the crash CPU when more than one CPU crashes simultaneously. 
Description 


The SHOW CRASH command has two different functions, depending on whether 
you use it to analyze a running system or a system failure. 


When used during the analysis of a running system, the SHOW CRASH command 
produces a display that describes the system and the version of OpenVMS that 

it is running. The system crash information display contains the following 
information: 


e Name and version number of the operating system 
e Major and minor IDs of the operating system 


e Identity of the OpenVMS system, including an indication of its cluster 
membership 


e CPU ID of the primary CPU 
e Address of all CPU databases 


When used during the analysis of a system failure, the SHOW CRASH command 
produces several displays that identify the system and describe its state at the 
time of the failure. 


If the current CPU context for SDA is not that of the processor that signaled the 
bugcheck, or the CPU specified with the /CPU=n qualifier, the SHOW CRASH 
command first performs an implicit SET CPU command to make that processor 
the current CPU for SDA. (See the description of the SET CPU command and 
Section 2.5 for a discussion of how this can affect the CPU context—and process 
context—in which SDA commands execute.) 


The system crash information display in this context provides the following 
information: 


e Date and time of the system failure. 
e Name and version number of the operating system. 


e Major and minor IDs of the operating system. 
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e Identity of the system. 


e CPU IDs of both the primary CPU and the CPU that initiated the bugcheck. 
In a uniprocessor system, these IDs are identical. 


e Bitmask of the active and available CPUs in the system. 


e For each active processor in the system, the address of its CPU database and 
the name of the bugcheck that caused the system failure. Generally, there 
will be only one significant bugcheck in the system. All other processors 
typically display the following as their reason for taking a bugcheck: 


CPUEXIT, Shutdown requested by another CPU 


Subsequent screens of the SHOW CRASH command display information about 
the state of each active processor on the system at the time of the system failure. 
The information in these screens is identical to that produced by the SHOW CPU 
command, including the registers (Alpha), exception frame (164), stack pointers, 
and records of spinlock ownership. The first such screen presents information 
about the processor that caused the failure; others follow according to the numeric 
order of their CPU IDs. For the processor that caused the failure, if an exception 
bugcheck (INVEXCEPTN, SSRVEXCEPT, FATALEXCEPT, UNXSIGNAL) or, for 
164 only, also a KRNLSTAKNV or DEBUGCRASH bugcheck has occurred, SHOW 
CRASH first displays the exception frame from the original exception. 


SHOW CRASH displays the original exception in process dumps, and additionally 
displays all CPU database addresses in system dumps. 


SDA> SHOW CRASH 


Version of 


system: OpenVMS (TM) Alpha Operating System, Version X901-SSB 


System Version Major ID/Minor ID: 3/0 


VMScluster 


node: VMSTS6, a 


Crash CPU ID/Primary CPU ID: 00/00 
Bitmask of CPUs active/available: 00000001/00000001 


CPU bugcheck codes: 
CPU 00 -- INVEXCEPTN, Exception while above ASTDEL 


System State at Time of Exception 


FFFFFFFF.810416C0 SCSSGA LOCALSB+005C0 
FFFFFFFF.81007E60 EXESGPL HWRPB L 
FFFFFFFF .850AEB80 ~ ~ 
FFFFFFFF.81041330 SCSSGA LOCALSB+00230 
FFFFFFFF.81038868 CONSINITLINE 
FFFFFFFF.81041330 SCSSGA LOCALSB+00230 
FFFFFFFF.803EF81C SYS$TTDRIVER+OF81C 
30000000.00001F04 
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FFFFFFFF.803EF80C: STL R24,#X0060(R5) 
FFFFFFFF.803EF810: LDL R28, #X0138(R5) 
FFFFFFFF.803EF814: BIC R28,R27,R28 
FFFFFFFF.803EF818: 00000138 

PC => FFFFFFFF.803EF81C: HALT 
FFFFFFFF.803EF820: HALT 
FFFFFFFF.803EF824: BR R31, #XFF0000 
FFFFFFFF.803EF828: LDL R24, #X0138(R5) 
FFFFFFFF.803EF82C: BIC R24, #X40,R24 

PS => 
MBZ SPAL MBZ IPL VMM MBZ CURMOD INT PRVMOD de 


0 30 00000000000 1F 0 0 KERN 1_ KERN 
Signal Array 


Length = 00000003 

Type = 0000043C 

Arg = FFFFFFFF.803EF81C SYSSTTDRIVER+0F81C 
Arg = 30000000.00001F04 


SSYSTEM-F-OPCDEC, opcode reserved to Digital fault at PC=FFFFFFFF803EF81C, PS=00001F04 


Saved Scratch Registers in Mechanism Array 


RO = 00000000.00000000 R1 = FFFFFFFF.811998B8 R16 = 00000000.00001000 
R17 = FFFFFFFF.8119B1FO R18 = 00000000.00000010 R19 = FFFFFFFF.810194F0 
R20 = 00000000.00000000 R21 = 0000000F.00000000 R22 = 00000000.00000000 
R23 = 00000000.00004000 R24 = 00000000.00001000 R25 = 00000000.00000000 
R26 = FFFFFFFF.81041474 R27 = 00000000.00004000 R28 = 00000000.00001000 


(CPU-specific display omitted) 


This long display reflects the output of the SHOW CRASH command within the 
analysis of a system failure on an OpenVMS Alpha system. 


2. SDA> SHOW CRASH 


System crash information 


Time of system crash: 12-OCT-2000 11:27:58.02 

Version of system: OpenVMS (TM) Alpha Operating System, Version X74B-FT2 
System Version Major ID/Minor ID: 3/0 

System type: DEC 3000 Model 400 

Crash CPU ID/Primary CPU ID: 00/00 

Bitmask of CPUs active/available: 00000001/00000001 


CPU bugcheck codes: 
CPU 00 -- PGFIPLHI, Pagefault with IPL too high 


System State at Time of Page Fault: 


Page fault for address 00000000.00046000 occurred at IPL: 8 
Memory management flags: 00000000.00000001 (instruction fetch) 
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Exception Frame: 


R2 = 00000000.00000003 
R3 = FFFFFFFF.810B9280 EXCEPTION MON+39C80 
R4. = FFFFFFFF.81564540 PCB ~ 
R5 = 00000000.00000088 
R6 = 00000000.000458B0 
R7 = 00000000. 7FFALFCO 
PC = 00000000.00046000 
PS = 20000000.00000803 
00000000.00045FFO0: LDO R2,#X0050(FP) 
00000000.00045FF4: LDQ R12, #X0058(FP) 
00000000.00045FF8: LDQ R13, #X0060(FP) 
00000000.00045FFC: LDO R14, #X0068(FP) 
PC => 00000000.00046000: BIS R1,R17,R1 
00000000.00046004: BIS R31,#X01,R25 
00000000.00046008: STO U R1,#X0002(R10) 
00000000.0004600C: BSR R26, #X00738C 
00000000.00046010: LDQ _U R16, #X0002(R10) 
PS => 
MBZ SPAL MBZ IPL VMM MBZ CURMOD INT PRVMOD de 


0 20 00000000000 08 0 0 KERN 0 - USER 


(CPU-specific display omitted) 


This display reflects the output of a SHOW CRASH command within the analysis 
of a PGFIPLHI bugcheck on an OpenVMS Alpha system. 


SDA> SHOW CRASH 


System crash information 


Time of system crash: 1-DEC-2003 13:31:10.50 


Version of system: OpenVMS 164 Operating System, Version XA2T-J2S 
System Version Major ID/Minor ID: 3/0 


System type: HP rx2600 (900MHz/1.5MB) 
Crash CPU ID/Primary CPU ID: 01/00 
Bitmask of CPUs active/available: 00000003/00000003 
CPU bugcheck codes: 
CPU 01 -- database address 8396DD80 -- SSRVEXCEPT, Unexpected system se 


1 other -- CPUEXIT, Shutdown requested by another CPU 
CPU 00 -- database address 83864000 


System State at Time of Original Exception 
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IPL 
TRAP TYPE 
IVT OFFSET 
IIP 

IIPA 

IFA 


IPSR 


PREVSTACK 
BSP 
BSPSTORE 
BSPBASE 
RNAT 


RSC 


PFS 


FLAGS 
STKALIGN 
PREDS 
THA 


INTERRUPT DEPTH 


ISR 


ITIR 


IFS 


BO 
Bl 
B2 
B3 
B4 
BD5 
B6 
B7 


GP 
R2 
R3 
R4 
R5 
R6 
R7 
R8 
RY 
R10 
R11 


KSP 
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00 


00000008 Access control violation 


00000800 


00000000.00020120 SYS$K_VERSION_08+00100 
00000000.00020110 SYS$K_VERSION_08+000F0 


00000000.00000000 
00001010. 0A0A6010 


RT TB LP DB SI 
1 0 1 0 0 
IA BN ED RI _ SS 
0 1 0 0 0 


00 
00000000. 7FF12240 
00000000. 7FF120C0 
00000000. 7FF120C0 
00000000.00000000 


00000000.00000003 


00000000.00000B9F 


PPL PEC RRB. 
0 0. 0. 
00 
000002D0 


00000000.FF562AA3 
FFFFFFFF. 7FF3E120 
00 


00000804.00000000 


ED EI SO NI 
1 0 0 0 0 


00000000. FFFF0934 


80000000.00000593 


Valid RRB. 


i. 0. 


FFFFFFFF.80241AE0 
80000000.FFD643B0 
00000000.00000000 
00000000.00000000 
00000000.00000000 
00000000. 7FF43E38 
00000000.00020110 
FFFFFFFF.80A28170 


00000000.00240000 
FFFFFFFF .839B8098 
E0000000.00000068 
FFFFFFFF .839731C0 
00000000.00000008 
00000000. 7FF43F40 
00000000.00000002 
00000000.00010000 
00000000.00000020 
00000000.0000003E 
00000000.00000001 


00000000. 7FF43EA0 


Data TLB Fault 


DI PP SP 
0 0 0 1 
DD DA ID 
0 0 0 1 


LOADRS BE PL 
0000 0 0 


PR RRB.FR 


IR RS SP NA R 


0 0 0 1 
KEY PS 
FFFF09 0D 
PR  RRB.FR  RRB.GR 
0. 0. 


DFH DFL DT 


IT MC 


RRB.GR 
0. 0. 


fault 


PK I 


0 
CPL 
0 


SOR 
0. 


SOR 
0. 


AMACSEMUL_CALL_NATIVE_C+00340 


SYS$K_VERSION_08+000F0 
NSASCHECK PRIVILEGE _C 


PSB+00058 


PCB 


SYS$K_VERSION_07 


1 


Ic MFH MFL AC BE UP 


1 


23. 


0 1 


SOL 
(32-54) 


0 0 0 


SOF 
31. (32-62) 


SOF 
19. (32-50) 


R13 
R14 
R15 
R16 
R17 
R18 
R19 
R20 
R21 
R22 
R23 
R24 
R25 
R26 
R27 
R28 
R29 
R30 
R31 


R32 
R33 
R34 
R35 
R36 
R37 
R38 
R39 
R40 
R41 
R42 


R43/OUTO 
R44/0UT1 
R45/OUT2 
R46/0UT3 
R47/0UT4 
R48/0UT5 
R49/OUT6 
R50/OUT7 


NATMASK 
NATS 
CSD 

SSD 

LC 

EC 


FPSR 


F6 
F7 
F8 
F9 
F10 
F1l 


PPREVMODE 


00000000. 
00000000. 
00000000. 
PREEEEFE:.. 
00000000. 
00000000 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000 
00000000. 
00000000. 
000007FD. 
FFFFFFFF. 


00000000. 
00000000. 
00000000. 
FFFFFFFF 
00000000. 
00000000. 
FFFFFFFF. 
00000000. 
FFFFFFFF 
00000000. 
00000000. 


00000000. 
E0000000. 
00000000. 
00000000 
00000000. 
00000000. 
00000000. 
FFFFFFFF. 


00000000. 
CFFFFFFF. 
CCCCOBAD. 
00000000. 
00000000. 


0009804Cc. 
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00000000 

00040008 UCBSM_SUPMVMSG+00008 
00020110 SYS$K VERSION 08+000F0 
802417A0 AMACS$EMUL_CALL NATIVE _C 
00010004 UCBSM DELETEUCB+00004 


.00040000 UCBSM CHAN TEAR DOWN 


00040000 UCBSM CHAN TEAR DOWN 
TFF43F38 _ ~ ~ 
7FF43F80 
00040000 UCBSM_CHAN TEAR DOWN 
00000000 
00000000 
00000000 
00000000 


- FF565663 


00000003 
TFF43EA0 
C0000300 
806549D0 PROCESS MANAGEMENT MON+677D0 


7AC9IDBCO 
00000001 
7FFCF88C MMGSIMGHDRBUF+0008C 


- 83973528 ARB+00230 


00000000 
00000000 
80A28410 NSASCHECK PRIVILEGE _C+002A0 
00000915 


-82D01640 SYSTEM PRIMITIVES+00221440 


00000B9F 
7FF43EA0 


7FFCF87C MMGSIMGHDRBUF+0007C 
00000068 
00000000 


- FF561663 


7FFCDA68 CTLSAG CLIDATA 
7FFCDBE8 CTL$AG_CLIDATA+00180 
00000003 

839731C0 PCB 


003A 
00000000 
00000000 
BADOCCCC 
00000000 
00000000 


0270033F SF3 SF2 SF1 SFO TRAPS 
004C 004C 004E 000C 3F 


OFFC9.C0000000.00000000 
1003E.00000000.00000018 
1000B.FF000000.00000000 
10007.A8000000.00000000 
10003.C2492492.49249249 
OFFF6.C30C30C3.0C30C30C 


03 
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Instruction Stream: 


{ .mfb 
SYS$K VERSION 08+000E0: nop.m 000000 
~ 7 nop.f 000000 
br.ret.sptk.many b0 ;; 
} 
{ .mii 
SYSSK VERSION 08+000F0: alloc r41 = ar.pfs, 0B, 08, 00 
~ ~ mov r29 = r12 
mov r42 = rl12 
yo 
{ .mmi 
PC => SYSSK VERSION 08+00100: 1d4 r24 = [r0] 3; 
~ ~ nop.m 000000 
sxt4 r24 = r24 ;; 
Pa oi 
{ .mii 
SYSSK_VERSION_08+00110: nop.m 000000 
sxt4 r14 = r24 +; 
cmp.eq p6, p7 = r14, r0 
} 
{ .mfb 
SYSSK VERSION 08+00120: nop.m 000000 
~ ~ nop.f 000000 
(p6) br.cond.dpnt.few 0000060 
} 
Signal Array 
Length = 00000005 
Type = 0000000C 
Arg = 00000000.00000000 
Arg = 00000000.00000000 
Arg = 00000000.00020120 
Arg = 00000000.00000003 


SSYSTEM-F-ACCVIO, access violation, reason mask=00, virtual address=0000000000000000, 
PC=0000000000020120, PS=00000003 


CPU 01 Processor state at time of SSRVEXCEPT bugcheck 


CPU 01 reason for Bugcheck: SSRVEXCEPT, Unexpected system service exception 
Process currently executing on this CPU: SYSTEM 

Current image file: IPFEX3$DKB200:[SYS0.][SYSMGR]X.EXE;2 

Current IPL: 0 (decimal) 

CPU database address: 8396DD80 

CPUs Capabilities: QUORUM, RUN 


Exception Frame at 00000000.7FF435B0 


IPL 7 00 

TRAP TYPE = 00000041 Bugcheck Breakpoint Trap 
IVT OFFSET = 00002C00 Break Instruction 

IIP_ = FFFFFFFF.80491E90 EXCEPTION MON+5E690 

IIPA = FFFFFFFF.80491E80 EXCEPTION MON+5E680 

IFA = 00000000.00030000 SYS$K_VERSION 01 
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KR5 (Next Timer) 
KR6 (CPUdb VA) 
KR7 (Slot VA) 


000000C4.FDFE03C8 
FFFFFFFF .83864000 
FFFFFFFF .8690F000 


SHOW CRASH 
IIM = 00000000.00100002 BREAKSC_SYS_BUGCHECK 
PPREVMODE = 00 
KRO = 00000000.00000000 
KR1 = 00000000.00000000 
KR2 = 00000000.00000000 
KR3 = 00000000.00000003 
KR4 = 00000000.00000000 
KR5 (Next Timer) = 000000BC.DEA95C24 
KR6 (CPUdb VA) = FFFFFFFF.8396DD80 
KR7 (Slot VA) = FFFFFFFF.86910000 
KSP = 00000000. 7FF43880 
ESP = 00000000. 7FF68000 
SSP = 00000000. 7FFAC000 
USP = 00000000. 7AC9DB60 
No spinlocks currently owned by CPU 01 
CPU 00 Processor state at time of CPUEXIT bugcheck 
CPU 00 reason for Bugcheck: CPUEXIT, Shutdown requested by another CPU 
Process currently executing on this CPU: None 
Current IPL: 31 (decimal) 
CPU database address: 83864000 
CPUs Capabilities: PRIMARY , QUORUM, RUN 
Exception Frame at FFFFFFFF.8696F9F0 
IPL - 1F 
TRAP_TYPE = 00000041 Bugcheck Breakpoint Trap 
IVT_OFFSET = 00002c00 Break Instruction 
IIP = FFFFFFFF.802F62F0 SYSTEM SYNCHRONIZATION+43BF0 
IIPA = FFFFFFFF.802F62F0 SYSTEM SYNCHRONIZATION+4 3BF0 
IFA = FFFFFFFF.86A280C0 
IIM = 00000000.00100002 BREAKSC_SYS_BUGCHECK 
PPREVMODE = 00 
KRO = 00000000.203D0000 
KR1 = 00000000.60000000 
KR2 = 00000000.00000000 
KR3 = 00000000.0001001F 
KR4 = 00000000.00000000 


KSP = FFFFFFFF.8696FCCO 
ESP = FFFFFFFF.86971000 
SSP = FFFFFFFF.86957000 
USP = FFFFFFFF.86957000 
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No spinlocks currently owned by CPU 00 


This example from an OpenVMS [64 system shows summary information on the 
crash: the time it occurred, its OpenVMS version, hardware type, and bugcheck 
codes. This is followed by the exception frame from the exception that triggered 
the crash, the instruction stream active at the time of the exception, and the 
signal array that describes the exception. The exception frame from the bugcheck 
triggered by the original exception is then displayed (that is, the bugcheck on the 
crash CPU) followed by the bugcheck exception frame for the other CPU in the 
system. 
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SHOW DEVICE 


Format 


Parameter 


Qualifiers 


Displays a list of all devices in the system and their associated data structures, 
or displays the data structures associated with a given device or devices. 


SHOW DEVICE [device-namef[:] |/ADDRESS=ucb-address | /BITMAP | 
/CDT=cdt_address |/CHANNELS | 
/HOMEPAGE |/PDT |/UCB=ucb-address] 


device-name 
Device or devices for which data structures are to be displayed. The following 
table lists several uses of the device-name parameter: 


To display the structures for: Take the following action: 

All devices in the system Do not specify a device-name (for 
example, SHOW DEVICE). 

A single device Specify an entire device-name (for 
example, SHOW DEVICE VTA20). 

All devices of a certain type on a Specify only the device type and controller 

single controller designation (for example, SHOW DEVICE 


RTA or SHOW DEVICE RTB). 
All devices of a certain type on any Specify only the device type (for example, 


controller SHOW DEVICE RT). 

All devices whose names begin with Specify the character or character string 
a certain character or character (for example, SHOW DEVICE D). 

string 


All devices on a single node or HSC Specify only the node name or HSC name 
(for example, SHOW DEVICE GREEN$). 


All devices with a certain allocation Specify the allocation class including 
class leading and trailing $, for example, 
SHOW DEVICE $63$. 


A colon (:) at the end of a device name is optional. 


Note 


All qualifiers specific to Memory Channel (CHANNELS, HOMEPAGE, 
and PDT) are disabled for OpenVMS I64 systems. 


/ADDRESS=ucb-address 

Indicates the device for which data structure information is to be displayed by the 
address of its unit control block (UCB). The /ADDRESS qualifier is an alternate 
method of supplying a device name to the SHOW DEVICE command. If both the 
device-name parameter and the /ADDRESS qualifier appear in a single SHOW 
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Description 


DEVICE command, SDA responds only to the parameter or qualifier that appears 
first. 


/BITMAP 

Displays information about data structures related to Write Bitmap 

(WBM). Bitmaps are used by Host-Base Volume Shadowing (HBVS) for the 
implementation of Mini Copy and Host-Based Minimerge (HBMM). If the 
/BITMAP qualifier is specified with a device that is not an HBVS virtual unit, the 
error NOSUCHDEYV is returned. 


A device name must be specified. If SHOW DEVICE/BITMAP DS is entered, bitmaps 
for all HBVS virtual units are displayed. 


/CDT=cdt_address 
Identifies the device by the address of its Connector Descriptor Table (CDT). This 
applies to cluster port devices only. 


/CHANNELS 
Displays information on active Memory Channel channel blocks. This qualifier is 
ignored for devices other than Memory Channel. 


/HOMEPAGE 
Displays fields from the Memory Channel Home Page. This qualifier is ignored 
for devices other than Memory Channel. 


/PDT 
Displays the Memory Channel Port Descriptor Table. This qualifier is ignored for 
devices other than Memory Channel. 


/UCB=ucb-address 
This is a synonym for /ADDRESS=ucb-address as described previously. 


The SHOW DEVICE command produces several displays taken from system data 
structures that describe the devices in the system configuration. 


If you use the SHOW DEVICE command to display information for more than 
one device or one or more controllers, it initially produces the device data 
block (DDB) list to provide a brief summary of the devices for which it renders 
information in subsequent screens. 


Information in the DDB list appears in five columns, the contents of which are 
as follows: 


e Address of the device data block (DDB) 

e Controller name 

e Name of the ancillary control process (ACP) associated with the device 
e Name of the device driver 

e Address of the driver prologue table (DPT) 


The SHOW DEVICE command then produces a display of information pertinent 
to the device controller. This display includes information gathered from the 
following structures: 


e Device data block (DDB) 
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e Primary channel request block (CRB) 
e Interrupt dispatch block (IDB) 
e Driver dispatch table (DDT) 


If the controller is an HSC controller, SHOW DEVICE also displays information 
from its system block (SB) and each path block (PB). 


Many of these structures contain pointers to other structures and driver routines. 
Most notably, the DDT display points to various routines located within driver 
code, such as the start I/O routine, unit initialization routine, and cancel I/O 


routine. 


For each device unit subject to the SHOW DEVICE command, SDA displays 
information taken from its unit control block, including a list of all I/O request 
packets (IRPs) in its I/O request queue. For certain mass storage devices, SHOW 
DEVICE also displays information from the primary class driver data block 
(CDDB), the volume control block (VCB), and the ACP queue block (AQB). For 
units that are part of a shadow set, SDA displays a summary of shadow set 


membership. 


As it displays information for a given device unit, SHOW DEVICE defines the 
symbols of Table 4—3 as appropriate: 


Table 4-3 SHOW DEVICE Symbols 


Symbol 


UCB 
SB 
ORB 
DDB 
DDT 
CRB 
SUD 
SHAD 
AMB 
IRP 
2P_UCB 
LNM 
PDT 
CDDB 


2P_CDDB 
RWAITCNT 
VCB 
2P_DDB 
VP_IRP 
MMB 


Meaning 


Address of unit control block 

Address of system block 

Address of object rights block 

Address of device data block 

Address of driver dispatch table 

Address of channel request block 

Address of supplementary VCB data 

Address of host-based shadowing data structure 
Associated mailbox UCB pointer 

Address of I/O request packet 

Address of alternate UCB for dual-pathed device 
Address of logical name block for mailbox 
Address of port descriptor table 


Address of class driver descriptor block for MSCP served 
device 


Address of alternate CDDB for MSCP served device 
Resource wait count for MSCP served device 
Address of volume control block for mounted device 
Address of secondary DDB 

Address of volume processing IRP 

Address of merge management block 


(continued on next page) 
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Table 4—3 (Cont.) SHOW DEVICE Symbols 


Symbol Meaning 

CPYLOCK ID of copier lock 

VU_TO Virtual Unit Timeout (seconds) 
VU_UCB UCB address of Virtual Unit 
MPDEV Address of multipath data structure 


PRIMARY_UCB UCB address for primary path 
CURRENT_UCB UCB address for current path 


If you are examining a driver-related system failure, you may find it helpful to 
issue a SHOW STACK command after the appropriate SHOW DEVICE command, 
to examine the stack for any of these symbols. Note, however, that although the 
SHOW DEVICE command defines those symbols relevant to the last device unit 
it has displayed, and redefines symbols relevant to any subsequently displayed 
device unit, it does not undefine symbols. (For instance, SHOW DEVICE DUAO 
defines the symbol PDT, but SHOW DEVICE MBAO does not undefine it, even 
though the PDT structure is not associated with a mailbox device.) To maintain 
the accuracy of such symbols that appear in the stack listing, use the DEFINE 
command to modify the symbol name. For example: 


SDA> DEFINE DUAQ_PDT PDT 
SDA> DEFINE MBA0_UCB UCB 


See the descriptions of the READ and FORMAT commands for additional 
information on defining and examining the contents of device data structures. 


Examples 

1. SDA> SHOW DEVICE/ADDRESS=8041E540 
OPAO VT300_Series UCB address 8041E540 
Device status: 00000010 online 


Characteristics: 0C040007 rec,ccl,trm,avl,idv,odv 


00000200 nnm 


Owner UIC [000001 ,000004] Operation count 160 ORB address 8041E4E8 
PID 00010008 Error count 0 DDB address 8041E3F8 

Class/Type 42/70 Reference count 2 DDT address 8041E438 

Def. buf. size 80 BOFF 00000001 CRB address 8041E740 

DEVDEPEND 180093A0 Byte count 0000012C I/O wait queue 8041E5AC 

DEVDEPND2 FB101000 SVAPTE 80537B80 

DEVDEPND3 00000000 DEVSTS 00000001 

FLCK index 3A 

DLCK address 8041E880 


x** I/O request queue is empty *** 


This example reproduces the SHOW DEVICE display for a single device unit, 
OPAO. Whereas this display lists information from the UCB for OPAO, including 
some addresses of key data structures and a list of pending I/O requests for the 
unit, it does not display information about the controller or its device driver. To 
display the latter information, specify the device-name as OPA (for example, 
SHOW DEVICE OPA). 
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2. SDA> SHOW DEVICE DU 
I/O data structures 


80D0B3C0 
8000B2B8 
80D08BA0 
80D08AE0 


DDB list 
Controller ACP 
BLUESSDUA F11XQP 
REDSDUA F11XQP 
BIGTOPSDUA F11X0QP 
TIMEINSDUA F11X0P 


Press RETURN for more. 


SYSSDKDRIVER 
SYSSDKDRIVER 
SYSSDKDRIVER 
SYSSDKDRIVER 
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DPT 


807735B0 
807735B0 
807735B0 
807735B0 


This excerpt from the output of the SHOW DEVICE DU command illustrates 
the format of the DDB list. In this case, the DDB list concerns itself with 
those devices whose device type begins with DU. It displays devices of these 
types attached to various HSCs (RED$ and BLUES$) and systems in a cluster 
(BIGTOP$ and TIMEIN$). 
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SHOW DUMP 


Displays formatted information from the header, error log buffers, logical memory 
blocks (LMBs), memory map, compression data, and a summary of the dump. 
Also displays hexadecimal information of individual blocks. 


Format 
SHOW DUMP [/ALLI/BLOCK[=n1f{: | ;}n]] 
|/COMPRESSION_MAP[=n1[:r[:p]]] 
|/ERROR_LOGS|/HEADER 
|/LMB[={ALL | n}] |/SUMMARY 
|/MEMORY_MAP] 
Parameters 
None. 
Qualifiers 
/ALL 


Displays the equivalent to specifying all the /SUMMARY, /HEADER, /ERROR_ 
LOGS, /COMPRESSION_MAP, /LMB=ALL, and /MEMORY_MAP qualifiers. 


/BLOCK[=n1{{: | ;}n]] 
Displays a hexadecimal dump of one or more blocks. You can specify ranges by 
using the following syntax: 


no value Displays next block 

m Displays single block 

mn Displays a range of blocks from m to n, inclusive 

mn Displays a range of blocks starting at m and continuing for n 
blocks 


/COMPRESSION_MAP[=n{{:n[:p]]] 

In a compressed dump, displays details of the compression data. You can 
specify levels of detail by using the following syntax, where m,n,p may each be 
wildcarded (*): 


no value Displays a summary of all compression map blocks. 

m Displays contents of a single compression map block. 

mn Displays details of single compression map entry. 

m:n:p Displays compressed and raw data for the specified compression 


section. Note that m:n:p may contain wildcards (*). 


/ERROR_LOGS 
Displays a summary of the error log buffers. 


/HEADER 
Displays the formatted contents of the dump header. 
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Examples 


1. 
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/LMB[={ALL | n}] 

In a selective dump, displays the formatted contents of logical memory block 
(LMB) headers and the virtual address (VA) ranges within the LMB. You can 
express LMBs to be displayed by using the following syntax: 


no value Displays next LMB 
n Displays LMB at block n of the dump 
ALL Displays all LMBs 


/MEMORY_MAP 
In a full dump, displays the contents of the memory map. 


/SUMMARY 
Displays a summary of the dump. This is the default. 


The SHOW DUMP command displays information about the structure of the 
dump file. It displays the header, the error log buffers, and, if appropriate, the 
compression map, the logical memory block (LMB) headers, and the memory map. 
Use this command when troubleshooting dump analysis problems. 


SDA> SHOW DUMP/SUMMARY 
Summary of dump file DKA300:[SYS0.SYSEXE]SYSDUMP.DMP;8 


Dump type: Compressed selective 
Size of dump file: 000203A0/000203A0 (132000./132000.) 
Highest VBN written: 0000D407 (54279.) 
Uncompressed equivalent: 0001AF1C (110364.) 
Compression ratio: 2.0321 (49.23) 
Uncomp Uncomp 

Dump file section VBN Blocks VBN blocks 
Dump header 00000001 00000002 
Error log buffers 00000003 00000020 
Compression map 00000023 00000010 
LMB 0000 (PT space) 00000033 00000038 00000033 000000D2 
LMB 0001 (S0/S1 space) 0000006B 0000621B 00000105 000095A5 
LMB 0002 (S2 space) 00006286 000001A3 000096AA 00000352 
LMB 0003 (Page tables of key process "SYSTEM") 00006429 00000005 000099FC 00000062 
LMB 0004 (Memory of key process "SYSTEM") 0000642E 00000071 O00009A5E 00000342 
LMB 0003 (Page tables of key process "NETACP") 0000697B 00000009 O000AE14 00000052 
LMB 0004 (Memory of key process "NETACP") 00006984 000013F7 OQ000AE66 00001F42 
LMB 0005 (Key global pages) 00007D7B 000002BA OQ000CDA8 00000312 
LMB 0006 (Page tables of process "DTWM") 00008035 00000013 O000D0BA 00000082 
LMB 0007 (Memory of process "DTWM") 00008048 000013A3 0000D13C 000022E4 
LMB 0006 (Page tables of process "Milord FTA1:") 0000C5E3 00000005 00019A44 00000062 
LMB 0007 (Memory of process "Milord FTA1:") QO00C5E8 00000074 00019AA6 00000222 
LMB 0008 (Remaining global pages) ~ 0000C65C 00000DAC 00019CC8 00001255 
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This example of the SHOW DUMP/SUMMARY command gives a summary of a 
selective dump. 


2. SDA> SHOW DUMP/HEADER 


Dump header 


Header field Meaning Value 


DMPSW FLAGS Flags 0OFC1 
~ DMPSV OLDDUMP: Dump has been analyzed 
DMP$V WRITECOMP: Dump write was completed 
DMPSV ERRLOGCOMP: Error log buffers written 
DMPSV DUMP STYLE: Selective dump 
~ ~ Verbose messages 
Dump off system disk 
Compressed 
DMPSB FLAGS2 Additional flags 09 
= DMP$V COMPRESSED: Dump is compressed 
DMP$V_ALPHADUMP: This is an OpenVMS Alpha dump 


DMP$Q_SYSIDENT System version "X69G-FT1" 
DMP$Q_LINKTIME Base image link date/time " 8-JUN-1996 02:07:27.31" 
DMP$L_SYSVER Base image version 03000000 
DMP$W_DUMPVER Dump version 0704 
DMP$L_DUMPBLOCKCNT Count of blocks dumped for memory 0000D3D5 
DMP$L_NOCOMPBLOCKCNT Uncompressed blocks dumped for memory 0001AEEA 
DMP$L_SAVEPRCCNT Number of processes saved 00000014 
EMBS$Q_CR_TIME Crash date/time " 3-JUL-1996 09:30:13.36" 
EMB$L_CR_CODE Bugcheck code "SSRVEXCEPT" 
EMB$B_CR_SCS_NAME Node name "SWPCTX " 
EMBS$T_CR_HW_NAME Model name "DEC 3000 Model 400" 
EMBS$T_CR_LNAME Process name "SYSTEM" 
DMP$L_CHECKSUM Dump header checksum 439E5E91 
This example of the SHOW DUMP/HEADER command shows the information in 
the header. 
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SHOW EXCEPTION_FRAME 


Format 


Parameter 


Qualifier 


Description 


Displays the contents of the exception frame at the given address or searches to 
display a one-line summary of all exception frames found on all applicable stacks. 


SHOW EXCEPTION_FRAME {address | [/SUMMARY] [range]} 


address 
Address of the exception frame. 


range 
Range of addresses specifiable as start:end or start;length. 


/SUMMARY (D) 


e The /SUMMARY qualifier is the default. 
e SHOW EXCEPTION and SHOW EXCEPTION range imply /SUMMARY. 


e Ifa range, either start:end or start;length, is given, then that range is 
searched instead of the stacks. 


Displays the contents of the exception frame at the given address (which is 
rounded down to an octaword-aligned address), or searches to display a one-line 
summary of all exception frames found on all applicable stacks. 


Under some circumstances, the exception frame of the actual bugcheck is copied 
(by BUGCHECK) to the system stack for the CPU. Since this stack is also 
searched, multiple hits may occur for this exception frame. 


On Alpha, the search for exception frames relies on valid processor status (PS) 
values in the PS offset from each possible 64-byte-aligned start address for an 
exception frame. Since only some of the bits in the PS can be validated, there 
may be frames displayed that are not exception frames (false positives). Do not 
assume that each frame displayed is actually an exception frame without further 
investigation. 


On 164, the search for exception frames is focused on the type/subtype offsets 
from each possible octaword-aligned start address for an exception frame. Thus, 
it is likely that frames displayed are exception frames. 
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Example 


SDA> show exception 


Exception Frame Summary 


Exception Frame Type Stack IIP / Ret_Addr 
00000000.7FF43BD0 INTSTK Kernel 00000000.00020150 
00000000.7FF43F40 SSENTRY Kernel 00000000.000200B0 
FFFFFFFF.872DFD00 INTSTK System FFFFFFFF.804D0980 


Trap Type / Code Address 


00000008 


806958B0 
00000041 


Access control violation 
fault 

PROCESS MANAGEMENT+658B0 
Bugcheck Breakpoint Trap 


The SHOW EXCEPTION_FRAME command example displays the summary. 


Examples of the display of the contents of an exception frame are available in the 


SHOW CRASH description. 
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SHOW EXECUTIVE 


Format 


Parameter 


Qualifiers 


Description 


Displays the location and size of each loadable image that makes up the 
executive. 


SHOW EXECUTIVE _[execlet-name | /SUMMARY/ALL] 


execlet-name 

Displays data only for the specified loadable image. You can use wildcards 
in execlet-name, in which case SDA displays data for all matching loadable 
images. 


/ALL 
Displays data for all loadable images. 


/SUMMARY (D) 
Displays a single line of output for all loadable images. This is the default. 


The executive consists of two base images and a number of other executive 
images. 


The base image called SYS$BASE_IMAGE.EXE contains: 

e Symbol vectors for universal executive routines and data cells 
e Procedure descriptors for universal executive routines 

e Globally referenced data cells 

The base image called SYS$PUBLIC_VECTORS.EXE contains: 

e Symbol vectors for system service procedures 

e Procedure descriptors for system services 

e Transfer routines for system services 


The base images are the pathways to routines and system service procedures in 
the other executive images. 


The SHOW EXECUTIVE command lists the location and size of each executive 
image with other information such as link date and time. It can enable you to 
determine whether a given memory address falls within the range occupied by a 
particular image. (Table 4—1 describes the contents of each executive image.) 


SHOW EXECUTIVE also displays the base address and length for each nonzero 
length image section. 


Executive images may be sliced. This means each different image section can be 
relocated in system memory so that the sections are no longer contiguous. The 
SHOW EXECUTIVE display contains information on where each image section 
resides. 
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The difference between a sliced image and a non-sliced image in the display is 
that the base, the end, and the length of a sliced image are blank. Only the 
image section base, end, and length are valid. 


On Alpha, there are six different image section types: nonpaged read only, 
nonpaged read-write, paged read only, paged read-write, init, and fixup. Each 
section type can occur only once. Only the image sections loaded into system 
memory are displayed. 


On 164, there are six different image section types: code, short data, read-only 
data, read-write data, init, and fixup. Some section types can occur more than 
once. Only the image sections loaded into system memory are displayed. 


The MAP command makes it easier to find out in which execlet an address 
resides. See the description of the MAP command for details. 


By default, SDA displays each location within an executive image as an offset 
from the beginning of the image, for instance, EXCEPTION+00282. Similarly, 
those symbols that represent system services point to the transfer routine in 
SYS$PUBLIC_VECTORS.EXE and not to the actual system service procedure. 
When tracing the course of a system failure through the listings of modules 
contained within a given executive image, you may find it useful to load into the 
SDA symbol table all global symbols and global entry points defined within one 
or all executive images. See the description of the READ command for additional 
information. 


The SHOW EXECUTIVE command usually shows all components of the 
executive, as illustrated in the following example. In rare circumstances, you 
may obtain a partial listing. For instance, after it has loaded the EXCEPTION 
module (in the INIT phase of system initialization), the system can successfully 
post a bugcheck exception and save a crash dump before loading all the executive 
images that are normally loaded. 


Examples 


1. SDA> SHOW EXECUTIVE 
VMS Executive layout summary 


Image LDRIMG SeqNum Base End Length SymVec 
SYSSMADDRIVER 8161BCCO 00000094 FFFFFFFF.837C2000 FFFFFFFF.837DDFFF 00000000.0001C000 
SYSSDADDRIVER 8161AB80 00000092 FFFFFFFF.82238000 FFFFFFFF.82247FFF 00000000.00010000 
SYSSLASTDRIVER 81617540 00000090 FFFFFFFF.813DA000 FFFFFFFF.813F5FFF 00000000.0001C000 
SYSSLTDRIVER 81611340 0000008E FFFFFFFF.813A2000 FFFFFFFF.813D9FFF 00000000.00038000 
LATSRATING 81611440 0000008C FFFFFFFF.8139A000 FFFFFFFF.813A1FFF 00000000.00008000 
PWIPDRIVER 8160B440 0000008A FFFFFFFF.81386000 FFFFFFFF.81399FFF 00000000.00014000 


ERRORLOG 814195c0 00000014 --< sliced >-- 
SYSTEM SYNCHRONIZATION 81418840 00000012 --< sliced >-- 
SYSTEM PRIMITIVES 81417ACO0 00000010 --< sliced >-- 
SYSTEM DEBUG 81416D40 OOQ0000E FFFFFFFF.83382000 FFFFFFFF.833E5FFF 00000000.00064000 
SYSSOPDRIVER 81415FCO 0000000C --< sliced >-- 
SYSSESBTDRIVER 81415240 0000000A --< sliced >-- 


The SHOW EXECUTIVE command displays a summary list of the executive 
images. The display has been moved left to fit within the page boundaries of the 
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manual. 


SDA> SHOW EXECUTIVE EX* 
VMS Executive layout 


EXCEPTION MON 
Data (read/write) FFFFFFFF.841BACO0 FFFFFFFF.841BAC13 00000000.00000014 00010000 
Data (read/write) FFFFFFFF.841BAE00 FFFFFFFF.841BAE03 00000000.00000004 00014000 
Code FFFFFFFF.8041E600 FFFFFFFF.80508D5F 00000000.000EA760 00018000 
Data (read only) FFFFFFFF.841BB000 FFFFFFFF.841C278F 00000000.00007790 00104000 
Data (read/write) FFFFFFFF.841C2800 FFFFFFFF.841D049F 00000000.0000DCA0 0010C000 
Data (read/write) FFFFFFFF.841D0600 FFFFFFFF.841D0613 00000000.00000014 0011C000 
Data (read only) FFFFFFFF.841D0800 FFFFFFFF.841D7D93 00000000.00007594 00120000 


Short data FFFFFFFF.841D7E00 FFFFFFFF.841DF247 00000000.00007448 00130000 

Linked 2-APR-2004 13:08 LDRIMG 84891900 SeqNum 00000022 GP FFFFFFFF .843D7E00 
EXEC_INIT 

Code FFFFFFFF.80327700 FFFFFFFF.803B304F 00000000.0008B950 00010000 


Data (read only) FFFFFFFF.84196C00 FFFFFFFF.8419D62F 00000000.00006A30 0009C000 
Data (read/write) FFFFFFFF.8419D800 FFFFFFFF.841A7987 00000000.0000A188 000A4000 
Short data FFFFFFFF.841A7A00 FFFFFFFF.841AA2DF 00000000.000028E0 000B0000 
Linked 23-MAR-2004 15:02 LDRIMG 84889040 SeqNum 0000001E GP FFFFFFFF.843A7A00 


This example from 164 displays the use of the wildcard with the SHOW 


EXECUTIVE command. The display has been moved left to fit within the 
page boundaries of the manual. 
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SHOW GALAXY 


Displays a brief one-page summary of the state of the Galaxy and all the 
instances in the Galaxy. 


Format 

SHOW GALAXY 
Parameters 

None. 
Qualifiers 

None. 
Example 


SDA> SHOW GALAXY 


Galaxy summary 


GMDB address Creator node ID Revision Creation time 
FFFFFFFF.7F234000 00000001 10 31-MAR-1999 13:15:08.08 0) 
Node ID NODEB address Name Version Join time 
00000000 FFFFFFFF.7F236000 ANDAIA 1,0 31-MAR-1999 14:11:09.08 
00000001 FFFFFFFF.7F236200 ANDA2A 1.0 31-MAR-1999 14:10:49.06 
00000002 FFFFFFFF.7F236400 ANDA3A 1.0 31-MAR-1999 14:13:26.16 
00000003 FFFFFFFF.7F236600 - Node block is empty - 


This SHOW GALAXY example shows the summary of the state of the Galaxy. 
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SHOW GCT 


Format 


Parameters 


Qualifiers 


Displays the contents of the Galaxy configuration tree either in summary 
(hierarchical format) or in detail, node by node. 


SHOW GCT  [/ADDRESS=n]| [/ALL]! [CHILDREN]! 
| [/HANDLE=n]| [/OWNER=n] | [/SUMMARY (default)] | [/TYPE=type] 


None. 


/ADDRESS=n 
Provides a detailed display of the Galaxy configuration tree (GCT) node at the 
given address. 


/ALL 
Provides a detailed display of all nodes in the tree. 


/CHILDREN 

When used with /ADDRESS=n or /HANDLE=n, the /CHILDREN qualifier causes 
SDA to display all nodes in the configuration tree that are children of the 
specified node. 


/HANDLE=n 
Provides a detailed display of the Galaxy configuration tree (GCT) node with the 
given handle. 


/OWNER=n 
Provides a detailed display of all nodes in the tree currently owned by the node 
with the given handle. 


/SUMMARY 
Provides a summary display of the Galaxy configuration tree (GCT) in 
hierarchical form. This qualifier is the default. 
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/TYPE=type 
Provides a detailed display of all nodes in the tree of the given type, which can be 
one of the following: 


BUS CAB COMMUNITY 

CPU CPU_MODULE EXP_CHASSIS 
FRU_DESC FRU_ROOT HARD_PARTITION 
HOSE HW_ROOT 1O_CTRL 

IOP MEMORY_CTRL MEMORY_DESC 
MEMORY_SUB PARTITION POWER_ENVIR 
PSEUDO RISER ROOT 

SBB SLOT SMB 

SOC SW_ROOT SYS_CHASSIS 
SYS_INTER_SWITCH TEMPLATE ROOT 


The type given may be an exact match, in which case just that type is displayed 
(for example, a CPU); or a partial match, in which case all matching types 

are displayed (for example, /TYPE=CP displays both CPU and CPU_MODULE 
nodes). 
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1. SDA> SHOW GCT 


Galaxy Configuration Tree summary 


Base address of Config Tree: 


414C4147-5958-0030-0000 


Handle Hierarchy Id 
00000000 Root 00000000.00000000 

| 
00000240 |_HW_Root 00000000.00000000 
00000280 | _IoP 00000000.00000006 
00000300 | _I0P 00000000.00000007 
00000380 | _I0P 00000000.00000008 
00000400 | _CPU_Module 00000000.00000000 
00000440 | _CPU 00000000.09000000 
00000480 | _CPU 00000000.1B000001 
000004C0 | _CPU_Module 00000000.00000001 
00000500 | _CPU 00000000.1B000002 
00000540 | _CPU 00000000.10000003 
00000580 | _CPU_Module 00000000.00000002 
000005C0 | _CPU 00000000.07000004 
00000600 | _CPU 00000000.0A000005 
00000640 | _CPU_Module 00000000.00000003 
00000680 | _CPU 00000000.07000006 
000006c0 | _CPU 00000000.0C000007 
00000700 | _Memory_Sub 00000000.00000000 
00000780 | _Memory_ Ctrl 00000000.00000005 
000007Cc0 | _Memory_Desc 00000000.00000000 

| _Fragment 

| _Fragment 

| _Fragment 
oo000a40 | _Memory_Desc 00000000.40000000 

| _Fragment 

| _Fragment 

| _Fragment 
00000CCO | _Memory_Desc 00000000.80000000 

| _Fragment 

| _Fragment 

| _Fragment 
oo000Fr4o | _Memory_Desc 00000000.c0000000 

| _Fragment 

| 
000011C0 |_SW_Root 00000000.00000000 
00001580 | | Community 00000000.00000000 
00001600 | _Partition 00000000.00000000 
00001700 | _Partition 00000000.00000001 
00001800 | _Partition 00000000.00000002 

| 
00001200 |_Template_Root 00000000.00000000 
00001240 |_IoP 00000000.00000000 
000012C0 |_cpu 00000000.00000000 
00001300 |_Memory Desc 00000000.00000000 


(2 pages) 


Initial 
Owner 


Current 
Owner 


00001800 
00001700 
00001600 
00001580 
00001600 
00001600 
00001580 
00001600 
00001600 
00001580 
00001700 
00001700 
00001580 
00001800 
00001800 
00001580 
00001600 
00001600 
00001600 
00001600 
00001600 
00001700 
00001700 
00001700 
00001700 
00001800 
00001800 
00001800 
00001800 
00001580 
00001580 


00001800 


00001800 


00001700 


00001800 


00001600 


000011C0 
00001580 
00001580 
00001580 


Name/Min PA/ 
Base PA 


000000A0.00000000 
000000B0.00000000 
000000C0.00000000 


00000000.00000000 


00000000.00000000 
00000000.00000000 
00000000.00200000 
00000000.3FF7E000 
00000000.40000000 
00000000.40000000 
00000000.40200000 
00000000.7FF7E000 
00000000.80000000 
00000000.80000000 
00000000.80200000 
00000000.BFF7E000 
00000000.C0000000 
00000000.c0000000 


ANDAIA 
ANDA2A 
ANDA3A 


OS type/Max PA/ 
Size (bytes) 


OO00000AF.FFFFFFFF 
000000BF.FFFFFFFF 
000000CF.FFFFFFFF 


00000000. FFFFFFFF 


00000000.40000000 
00000000.00200000 
00000000.3FD7E000 
00000000.00082000 
00000000.40000000 
00000000.00200000 
00000000.3FD7E000 
00000000.00082000 
00000000.40000000 
00000000.00200000 
00000000.3FD7E000 
00000000.00082000 
00000000.40000000 
00000000.40000000 


OpenVMS Alpha 
OpenVMS Alpha 
OpenVMS Alpha 


00000000.02000000 
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Primary 


Primary 


Primary 


Console 
Private 
Console 


Console 
Private 
Console 


Console 
Private 


Console 


Shared 


Private 
Base 
Private 


Private 
Base 
Private 


Private 
Base 
Private 


VM-0770A-Al 


Base 


Base 


Base 


Base 


Base 


Base 


This command shows the summary (hierarchical) display of the configuration 


tree. 
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2. SDA> SHOW GCT/HANDLE=00000700 


Galaxy Configuration Tree 


Handle: 00000700 Address: FFFFFFFF .83694740 
Node type: Memory Sub Size: 0080 
Id: 00000000.00000000 Flags: 00000000.00000001 Hardware 


Related nodes: 


Node relationship Handle Type Id 

Initial owner 00001580 Community 00000000.00000000 
Current owner -<Same>- 

Parent 00000240 HW_Root 00000000.00000000 
Previous sibling 00000640 CPU_Module 00000000.00000003 
Next sibling -<None>- 

Child 00000780 Memory Ctrl 00000000.00000005 
Configuration binding 00000240 HW_Root 00000000.00000000 
Affinity binding 00000240 HW_Root 00000000.00000000 


Min. physical address:  00000000.00000000 
Max. physical address: 00000000.FFFFFFFF 


This command shows the detailed display of the specified node. 
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SHOW GLOBAL_SECTION_TABLE 


Format 


Parameters 


Qualifiers 


Description 


Displays information contained in the global section table, including pageable 
sections of loadable images. 


SHOW GLOBAL_SECTION_TABLE [/SECTION_INDEX=n] 
SHOW GST [/SECTION_INDEX=n] 


None. 


/SECTION_INDEX=n 
Displays only the global section table entry for the specified section. 


Displays the entire contents of the global section table, unless you specify 

the qualifier /SECTION_INDEX. This command is equivalent to SHOW 
PROCESS/PROCESS_SECTION_TABLE/SYSTEM. SDA displays the information 
in Table 4—4 for each GST entry. 


Table 4-4 Global Section Table Entry Information 


Part Definition 


INDEX Index number of the entry. Entries in the global section 
table begin at the highest location in the table, and the table 
expands toward lower addresses. 

ADDRESS Address of the global section table entry. 

SECT/GPTE Virtual address that marks the beginning of the first page of 
the section described by this entry, if a loadable image; or the 
virtual address of the global page table entry for the first page, 
if a global section. 


GSD Address of the corresponding Global Section Descriptor. This 
field is zero for loadable images. 

PAGELETS Length of the global section. This is in units of pagelets, 
except for a PFN-mapped section in which the units are pages. 

VBN Virtual block number. The number of the file’s virtual block 
that is mapped into the section’s first page. 

WINDOW Address of the window control block on which the section file 
is open. 


(continued on next page) 
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SHOW GLOBAL_SECTION_TABLE 


Table 4—4 (Cont.) Global Section Table Entry Information 


Part 


Definition 


REFCNT 
FLINK 
BLINK 


FLAGS 


Number of pages of this section that are currently mapped. 
Forward link. The pointer to the next entry in the GST list. 
Backward link. The pointer to the previous entry in the GST 


list. 


Flags that describe the access that the system and processes 
have to the global section. 


Example 


SDA> SHOW GST 


Global Section Table 


Last entry allocated 00000238 
First free entry 00000000 

Global section table 

Index Address Sect/GPTE Addr CCB/GSD Pagelets VBN Window 
00000001 81409FD8 FFFFFFFF.83384000 00000000 00000025 00000003 81419E40 
00000002 81409FBO FFFFFFFF.833AE000 00000000 00000064 00000220 8141A040 
00000003 81409F88 FFFFFFFF.83312000 00000000 00000001 0000063A 81450BCO 
00000004 81409F60 FFFFFFFF.833C0000 00000000 00000003 00000003 814233C0 
00000005 81409F38 FFFFFEFE.00058890 82065C70 00000002 0000000D 814F9ACO 

Name = INS$82065BC0_003 

File = DISK$X97D_R2Y:[VMSSCOMMON.SYSLIB]DECW$TRANSPORT_COMMON.EXE;1 
00000006 81409F10 FFFFFFFF.833E6000 00000000 00000011 00000023 8142E480 
00000007 81409EE8 FFFFFEFE.00052010 82025CA0 0000000C 00000004 814Cc0600 

File = DISK$X97D_R2Y:[VMSSCOMMON.SYSLIB]SYS$SSISHR.EXE;1 
00000008 81409ECO FFFFFFFF.83400000 00000000 000000B4 00000003 81446340 
00000009 81409E98 FFFFFFFF.83418000 00000000 00000038 000000B7 81446340 
Q000000A 81409E70 FFFFFEFE.00052028 820261B0 00000027 00000019 814C0ACO 

Name = INS$82026130_006 

File = DISK$X97D_R2Y:[VMSS$COMMON.SYSLIB]DISMNTSHR.EXE; 1 
0000000B 81409E48 FFFFFEFE.00052050 82026630 0000007A 00000004 814c0D00 

Name = INS$82026540_002 

File = DISK$X97D_R2¥Y:[VMSSCOMMON.SYSLIB]DTIS$SHARE.EXE; 1 
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Refcnt Flink 


00000003 


00000007 


00000001 


00000001 


00000003 


00000002 


00000000 


0000000C 


00000001 


00000003 


00000008 


000B 


000B 


AMOD=KRNL 


AMOD=KRNL 


CRF WRT AMOD=KRNL 


AMOD=KRNL 


WRTMOD=EXEC AMOD=USER PERM 


SYSGBL 


AMOD=KRNL 


WRTMOD=EXEC AMOD=USER PERM 
SYSGBL 


AMOD=KRNL 


CRF WRT AMOD=KRNL 


WRTMOD=EXEC AMOD=USER PERM 


SYSGBL 


WRTMOD=EXEC AMOD=USER PERM 
SYSGBL 
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SHOW GLOCK 


Format 


Parameters 


Qualifiers 


Displays the Galaxy locks for the Galaxy Management Database (GMDB), process 
tables, and/or system tables. 


SHOW GLOCK  [/BRIEF] 
[/GMDB_TABLE] 
[/PROCESS_ TABLE [=n] 
[/SYSTEM_TABLE [=n] 
V/ALL] 
[/ADDRESS=n [/PHYSICAL]] 
[/HANDLE=n [/LINKED]] 


None. 


/BRIEF 
Displays a single line for each Galaxy lock, regardless of any other qualifiers. 


/GMDB_TABLE 
Displays the Galaxy lock table for the Galaxy Management Database (GMDB) 
including the embedded and attached Galaxy locks. 


/PROCESS_TABLE [=n] 

Displays all the process Galaxy lock tables with the embedded and attached 
Galaxy locks, as well as a summary table. The /PROCESS_TABLE=n qualifier 
displays the single Galaxy lock table without a summary page. 


/SYSTEM_TABLE [=n] 

Displays all the system Galaxy lock tables with the embedded and attached 
Galaxy locks, as well as a summary table. The /SYSTEM_TABLE=n qualifier 
displays the single Galaxy lock table without a summary page. 


/ALL 

Displays information provided by the /GMDB_TABLE, /PROCESS_TABLE, and 
/SYSTEM_TABLE qualifiers. The /ALL qualifier also displays information from 
the base GMDB Galaxy lock. 


/ADDRESS=n [/PHYSICAL] 

Displays the single Galaxy lock at address n. Because process Galaxy locks are 
located by their physical address, you must use the /PHYSICAL qualifier to enter 
such an address. 


/HANDLE=n [/LINKED] 
Displays the single Galaxy lock whose handle is n. The optional qualifier 
/LINKED causes SDA to display all Galaxy locks linked to the one specified. 
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Examples 


1. SDA> SHOW GLOCK 
Galaxy Lock Database 


Base address of GLock segment of GMDB: 


Length: 


Nodes: 


Process tables: 
First free: 
First used: 


Embedded GLocks: 
GLock address: 


GLock name: 
Owner count: 
Node sequence: 
IPL: 

Wait bitmask: 
Thread ID: 


GLock address: 


GLock name: 
Owner count: 
Node sequence: 
IPL: 

Wait bitmask: 
Thread ID: 


GLock address: 


GLock name: 
Owner count: 
Node sequence: 
IPL: 

Wait bitmask: 
Thread ID: 


00000000.00000007 


00000000.00000400 
00000002 
00000001 


FFFFFFFF . 7F238020 
GMDB_GLOCK_LOCK 


00000000.00000000 
00000000.00000000 


FFFFFFFF .7F238190 
PRC_LCKTBL_LOCK 


00000000.00000000 
00000000.00000000 


FFFFFFFF.7F2381D0 
SYS_LCKTBL LOCK 


00000000.00000000 
00000000.00000000 


FFFFFFFF.7F238000 
00000000.00082000 


This example shows the summary of the Galaxy lock database. 


SDA> SHOW GLOCK/PROCESS_ TABLE 
Galaxy Lock Database: Process Lock Table #0001 


Base address of Process Lock Table #0001: 


Lock size: 


Region Index/Sequence: 
Region physical size: 
Number of locks: 


0040 
0008/00000001 
00000000.00002000 
00000000.00000080 


Per-node reference counts: 


Node Count 
0000 0001 
0001 0001 
0002 0001 


Embedded GLock: 
GLock address: 
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FFFFFFFF.7F23A040 


01 VALID 


Flags: 00000000.00000000 
System tables: 00000000.00000400 
00000001 
00000000 
Handle: 80000000.00000805 
Flags: 00 
Owner node: 00 
Owner: 000000 
Previous IPL: 00 
Timeout: 00000000 
Handle: 80000000.00000833 
Flags: 00 
Owner node: 00 
Owner: 000000 
Previous IPL: 00 
Timeout: 00000000 
Handle: 80000000.0000083B 
Flags: 00 
Owner node: 00 
Owner: 000000 
Previous IPL: 00 
Timeout: 00000000 
FFFFFFFF.7F23A000 
Flags: 
Access mode: 03 


Virtual size: 
Nodes: 


Handle: 


00000000.00002000 
00000000.00000007 


80000000.00000C09 


GLock name: 
Owner count: 
Node sequence: 
IPL: 

Wait bitmask: 
Thread ID: 


Attached GLocks: 
GLock address: 


GLock name: 
Owner count: 
Node sequence: 
IPL: 

Wait bitmask: 
Thread ID: 


GLock address: 


GLock name: 
Owner count: 
Node sequence: 
IPL: 

Wait bitmask: 
Thread ID: 


Used GLock count 


Free GLock count 


PLCKTBL LOCK001 


00000000.00000000 
00000000.00000000 


P00000000.C05EC7C0 
CPU_BAL LOCK 


00000000.00000000 
00000000.00000000 


P00000000.C05EC000 
CPU_BAL LOCK 


00000000.00000000 
00000000.00000000 


Flags: 
Owner node: 
Owner: 


Previous IPL: 


Timeout: 


Handle: 


Flags: 
Owner node: 
Owner: 


Previous IPL: 


Timeout: 


Handle: 


Flags: 
Owner node: 
Owner: 


Previous IPL: 


Timeout: 


Galaxy Lock Database: Process Lock Table Summary 


Total used Process Lock Tables: 
Total free Process Lock Tables: 


00000001 
000003FF 
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00000000 


00000001.000000F9 


00000000 


00000001.00000001 


00000000 


This example shows the Galaxy locks for all processes. 


SDA Commands 4-115 


SDA Commands 
SHOW GMDB 


SHOW GMDB 


Format 


Parameters 


Qualifiers 


Examples 


Displays the contents of the Galaxy Management Database (GMDB) and/or the 
node blocks of the instances in the Galaxy system. 


SHOW GMDB_ [/ALL] 


[/NODE [=name|=n|/ADDRESS=n] [/SUMMARY] 


None. 


/ADDRESS 
Specifies the address of a single node block to be displayed when used with the 
/NODE qualifier. See the description of the /NODE qualifier. 


/ALL 
Displays the contents of the Galaxy Management Database and all node blocks 
that have ever been used (contents nonzero). 


/NODE [=namel=n|/ADDRESS=n] 

Displays the contents of the specified node block, given by either the name of the 
instance, the partition number, or the address of the node block. If the /NODE 
qualifier is given alone, then the node block for the current instance is displayed. 


/SUMMARY 
Displays a one-page summary of the GMDB and all node blocks. 


Note 


The default action displays the contents of the Galaxy Management 
Database. 


ds SDA> SHOW GMDB 


Galaxy Management Database 


Base address of GMDB: 


Base address of NODEB for this instance: 


FFFFFFFF.7F234000 
FFFFFFFF.7F236000 


Revision: 1.0 Maximum node ID: 00000003 
Creation time: 31-MAR-1999 13:15:08.08 Incarnation: 00000000.00000003 
State: OPERATIONAL Creator node: 00000001 
Base size: 00000000.00004000 Total size: 00000000.000A6000 
Last joiner ID: 00000002 Remover node ID: FFFFFFFF 
Last leaver ID: 00000002 Node timeout (msec) 5000. 
Lock owner 00000002 Lock flags: 0000 
Break owner: FFFFFFFF Breaker ID: FFFFFFFF 


Version Information: 
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SHOW GMDB 
Min Version Operational 1.0 Min Version Allowed 1.0 
Max Version Operational 1.0 
Membership bitmask: FFFFFFFF .7F236800 
Valid bits: 00000004 State: 00000000.0000001E AUTO LOCK TIMEOUT CRASH.... 
Unit count: 0001 Unit size: QUADWORD 
Lock IPL: 16 Saved IPL: 00000008 
Count of bits set: 00000003 
Timeout count: 000186A0 
Summary bitmask: 00000000.00000001 
Unit bitmask: 
siGelalacavats, Alaroiaiinatae.-sanaeniete eel: see etaarae 7 00000000 
Remove node bitmask: FFFFFFFF .7F236880 
Valid bits: 00000004 State: 00000000.00000018 SUMMARY BITS SET COUNT 
Unit count: 0001 Unit size: QUADWORD 
Count of bits set: 00000000 
Summary bitmask: 00000000.00000000 
Unit bitmask: 
ahalatoniacsislt jee wuenatarene: nkaterwra aravet. "aveietamave 0 00000000 
Subfacility validation flags: 00000000 
Galaxy locks segment: FFFFFFFF.7F238000 Length: 00000000.00082000 
Shared memory segment: FFFFFFFF.7F2BA000 Length: 00000000.0000A000 
CPU comms segment: FFFFFFFF.7F2C4000 Length: 00000000.00014000 
CPU info segment: FFFFFFFF.7F2D8000 Length: 00000000.00002000 
Membership segment: FFFFFFFF.7F2DA000 Length: (empty ) 
MMAP address: FFFFFFFF .7F234200 
Level count: 0000 Flags: 0001 VALID 
Top page count: 00000053 Virtual size:  00000000.000A6000 
PFN list page count: 00000000 First PFN: 00060000 
Data page count: 00000053 


This example shows the overall summary of the Galaxy Management Database. 


2. SDA> SHOW GMDB/NODE=0 
GMDB: Node ID 00000000 (current instance) 


Base address of node block: FFFFFFFF.7F236000 
Version: 1.0 Node name: ANDAIA 
Join time: 31-MAR-1999 14:11:09.08 Incarnation: 00000000.00000005 
State: MEMBER Crash_all acknowledge: 00000000 
Validation done: 00000000 Reform done: 00000000 
IP interrupt mask: 00000000.00000000 

Little brother: 00000002 Heartbeat: 00000000.0019EAD1 

Big brother: 00000001 Last watched_node: 00000000 
Watched_node #0: FFFFFFFF.7F236078 Node watched: 00000002 
Last heartbeat: 00000000.0017C1AD Miss count: 00000000 


This example shows Galaxy Management Database information for the specified 
instance. 
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SHOW GSD 


Displays information contained in the global section descriptors. 


Format 
SHOW GSD [/ADDRESS=n1/ALL|/DELETED | /GLXGRP 
|/GLXSYS |/GROUP |/SYSTEM] 
Parameters 
None. 
Qualifiers 
/ADDRESS=n 


Displays a specific global section descriptor entry, given its address. 


/ALL 

Displays information in all the global section descriptors, that is, the system, 
group, and deleted global section descriptors, plus the Galaxy group and Galaxy 
system global section descriptors, if the system or dump being analyzed is a 
member of an OpenVMS Galaxy system. This qualifier is the default. 


/DELETED 
Displays information in the deleted (that is, delete pending) global section 
descriptors. 


/GLXGRP 
Displays information in the group global section descriptors of a Galaxy system. 


/GLXSYS 
Displays information in the system global section descriptors of a Galaxy system. 


/GROUP 
Displays information in the group global section descriptors. 


/SYSTEM 
Displays information in the system global section descriptors. 


Description 


The SHOW GSD command displays information that resides in the global section 
descriptors. Table 4—5 shows the fields and their meaning. 
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Field Meaning 

ADDRESS Gives the address of the global section descriptor. 

NAME Gives the name of the global section. 

GSTX Gives the global section table index. 

FLAGS Gives the settings of flags for specified global section, as a 
hexadecimal number; also displays key flag bits by name. 

BASEPFN! Gives physical page frame number at which the section starts. 

PAGES! Gives number of pages (not pagelets) in section. 

REFCNT! Gives number of times this global section is mapped. 


1This field applies only to PFN mapped global sections. 


SDA > SHOW GSD 


System Global Section Descriptor List 


ADDRESS 


817DAF30 
817DAE60 
817DAD90 
817DACCO 
817DABE0 
817DAB00 
817DA890 
817DA850 


NAME 


SECIDX_422 
SECIDX_421 
SECDIX_420 
SECDIX_419 
SECIDX_418 
SECIDX_417 
SECIDX_412 
SECIDX_411 


FLAGS 


0082C3C9 
008A83CD 
0088C3CD 
008883DC 
0001C3C1 
0001C3C1 
0080C3CD 
008083CD 


WRT AMOD=USER PERM 
DZRO WRT AMOD=USER 
DZRO WRT AMOD=USER 
DZRO WRT AMOD=USER 
AMOD=USER PERM 

AMOD=USER PERM 

DZRO WRT AMOD=USER 
DZRO WRT AMOD=USER 


PAGFIL 
PERM PAGFIL 
PAGFIL 


PERM 


BASEPFN PAGES REFCNT 


00000B0B 00000002 00000000 
00000B0B 00000002 00000000 


ZK-8830A-GE 
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SHOW GST 


SHOW GST 


See SHOW GLOBAL _SECTION_TABLE. 


4-120 SDA Commands 


SDA Commands 
SHOW HEADER 


SHOW HEADER 


Displays the header of the dump file. 


Format 
SHOW HEADER 


Parameters 


None. 


Qualifiers 


None. 


Description 


The SHOW HEADER command produces a 10-column display, each line of which 
displays both the hexadecimal and ASCII representation of the contents of 

the dump file header in 32-byte intervals. Thus, the first eight columns, when 
read right to left, represent the hexadecimal contents of 32 bytes of the header; 
the ninth column, when read left to right, records the ASCII equivalent of the 
contents. (The period [.] in this column indicates an ASCII character that cannot 
be displayed.) 


After it displays the contents of the header blocks, the SHOW HEADER command 
displays the hexadecimal contents of the saved error log buffers. 


See the OpenVMS AXP Internals and Data Structures manual for a discussion of 
the information contained in the dump file header. See also the SHOW DUMP 
and CLUE ERRLOG commands, which you can use to obtain formatted displays 
of the dump header and error log buffers. 


Example 


SDA> SHOW HEADER 


Dump file header 


00000000 7FFA6000 00000000 7FFA1C98 00000000 0000187C 08090FC1 00000004 ....A...|......... is, sissace:s Ute esses 00000000 
00001FFF 0000000D 00002000 80D0A000 00000000 7AFFBADO 00000000 7FFAC100 .Ad..... Do Ziview es Diaraya seis ayes e:e 00000020 
0000B162 00000000 00000001 00000000 00040704 FCFFFFFF 03000000 80C13670 p6A........ 1 sianstyavney ayarereceusvetiete a bt.. 00000040 
00000000 00000400 00000008 00000000 3154462D 31393658 00000011 00000000 ........ MO QUS PTT cccrersiaiaisse esate catereve 00000060 
00000000 00000000 00000000 00000000 00000000 00000000 00000000 O0D000000 ... cc cece cece cece eee e cece eceeee 00000080 
00000000 00000000 00000000 00000000 00000000 00000000 00000000 O0000000 .... cece eee ee eee ence eens see eeee 000000A0 


FF7FC000 FFFFFFFD FF000000 80C220F0 00000000 00000000 00000000 00000000 ............ 6 Asssss Y----A.eeeee 000000C0 


Saved error log messages 


0004FFF9 0000040B 00000001 00000000 00000070 80D0B000 80D0A00C 00000000 ...... DecODsPiwas eee Wish araislaiane aves x 80D0A000 


B4510020 60030000 00000000 00000020 20585443 50575308 00000000 00020000 ... -.-SWPCTX . tf Op veravae 80D0A020 
30303320 43454412 00000002 00000000 3154462D 31393658 0000009A 2C31075A 2Z.1,....X691-FT1.. --DEC 300 80D0A040 
000000AA 59EC7COA 00000000 00000000 00000000 00303034 206C6564 6F4D2030 0 Model 400.............. jiya... 80D0A060 
20585443 50575308 00000000 00020000 0004FFF9 0000040B 00000001 00000000 ............ Uiseristerwrersreteheaee SWPCTX 80D0A080 
3154462D 31393658 0001009A 2C3107FD 1DDB0040 60030000 00000000 00000020 .......... “@.0.9.1,....X691-FT1 80DO0A0A0 
00000000 00303034 206C6564 6F4D2030 30303320 43454412 00000003 00000000 ......... DEC 3000 Model 400..... 80D0A0CO 
4B442458 54435057 530A0064 000001AB 00000000 00010001 00000000 00000000 ...............- «...d. .SWPCTX$DK 80D0A0EO 

ZK-8861A-GE 
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SHOW HEADER 


The SHOW HEADER command displays the contents of the dump file’s header. 
Ellipses indicate hexadecimal information omitted from the display. 
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SDA Commands 
SHOW IMAGE 


SHOW IMAGE 


Displays information about an image, regardless of the type of image (executive, 
activated, or installed). 


Format 
SHOW IMAGE _ image-name 


Parameters 


image-name 
Name of the image to be displayed. This is a required parameter that may 
include wildcards. 


Qualifiers 


None. 


Description 


Searches the executive image list for the image name, and, if a match is found, 
displays the loaded image information. Next, searches the activated image list for 
the process (if SDA has a current process context). If a match is found, displays 
the activated image information. Finally, searches the installed image lists, 
directory by directory. If a match is found, displays the installed image (known 
file entry) information. 


SHOW IMAGE x is equivalent to SHOW EXECUTIVE x followed by SHOW PROCESS/ IMAGE=x 
followed by SHOW KFE x. 


Example 
SDA> show image sys$public_ vectors 


Image SYSS$PUBLIC_VECTORS 


Image Base End Length ImageOff SymVec 

SYS$PUBLIC_VECTORS 81804B18 
Nonpaged read only FFFFFFFF.80000000 FFFFFFFF.800025FF 00000000.00002600 00000000 
Nonpaged read/write FFFFFFFF.81800000 FFFFFFFF.81807FFF 00000000.00008000 00004000 


Linked 30-AUG-2004 09:36 LDRIMG 81C17480 SeqNum 00000000 --< sliced >-- 


Process activated images 


Image Name/Link Time/Section Type Start End Type/File Id 


SYS$PUBLIC_VECTORS 81804B18 818071B7 GLBL 
IMCB Sym Vect Maj,Minor ID Base End ImageOff 


TFF6A250 81804B18 113,16596271 


Known File Entries 
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SHOW IMAGE 
KFE Image Name/ KFERES Address/ File ID/ Flags/ 
Address Section Type Base End ImageOff 
82984C50 SYSS$PUBLIC_VECTORS;1 (3923,194,0) 


This example shows the output from SHOW IMAGE for SYS$PUBLIC_ 
VECTORS. Part of the example has been moved left to stay within page 
boundaries of the manual. 
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SDA Commands 
SHOW KFE 


SHOW KFE 


Displays information about known file entries (installed images). 


Format 
SHOW KFE_[image_name!/ADDRESS=kfe_address | /ALL] 


Parameters 
image-name 
Name of the image to be displayed. This may include wildcards, but cannot 
include device or directory information. 


Qualifiers 


/ADDRESS=kfe_address 

Specifies the address of a single KFE of interest. The details are displayed for 
this KFE with device/directory information from the corresponding KFD (Known 
File Directory). 


/ALL 
Displays details for all KFEs, including device/directory information from the 
corresponding KFDs, with the contents of the Known File Pointer Block (KFPB). 


Description 


The SHOW KFE command displays information about known files (installed 
images). By default, a summary line without image-section information is given 
for each image. Use the /ALL qualifier to obtain detailed information for all 
images. For a single image, specify the image name or KFE address. 


The image_name parameter, the /ADDRESS, and /ALL qualifers cannot be used 
together. SHOW KNOWN FILE ENTRY is a synonym for SHOW KFE. 


Examples 


SDA> SHOW KFE 
Known File Entries 


KFPB address: 8292D860 
Hash table address: 82975360 
Hash table size: 0080 
Entry count: 016F 


KFD Device/Directory/Type: $31$DKB100:<SYS0.SYSCOMMON.CDESDEFAULTS. SYSTEM. BIN>.EXE 


KFD address: 829E8D60 
Reference count: 0002 
KFE Image Name KFERES Address File ID Flags 
829E8290 DECWSLOGINOUT; 1 (7204,49,0) LIM Open HdrRes Shared 
829E8DB0 DTGREET;1 (5651,19,0) Open HdrRes Shared 


KFD Device/Directory/Type: $31$DKB100:<SYS0.SYSCOMMON.SYSEXE>.EXE 


KFD address: 8299C140 
Reference count: 0066 
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SHOW KFE 
KFE Image Name KFERES Address File ID Flags 

8299C210 AUTHORIZE; 1 (72,176,0) ProcPriv AuthPriv 

829ACE10 BACKUP; 1 (73,176,0) 

8299C2A0 CDU;1 (75,176,0) ProcPriv Open HdrRes AuthPriv 
8299C660 CIA;1 (510,176,0) ProcPriv AuthPriv 

829ACE90 CONVERT; 1 (77,176,0) 

829A3AD0 COPY;1 829A3E70 (78,176,0) Open HdrRes Shared 


829ACF10 CREATE;1 (79,176,0) 


This example shows the first page of summary output for all known images. 


SDA> show kfe decc* 


Known File Entries 


KFE Image Name/ KFERES Address/ File ID/ Flags/ 
Address Section Type Base End ImageOff 
829900B0 DECCSSHR;1 82990960 (2431,189,0) LIM Open HdrRes 
Shared ResCode 

Paged read only FFFFFFFF.80A70000 FFFFFFFF.80C815FF 00000000 
Initialization 00000000.7BEC0000 00000000.7BFOODFF 00220000 
Fixup 00000000.7BF10000 00000000.7BF1B1FF 00270000 
Nonpaged read/write 00000000.7BF20000 00000000.7BF2FBFF 00280000 
Nonpaged read/write 00000000.7BF30000 00000000.7BF309FF 00290000 
Fixup 00000000.7BF40000 00000000.7BF401FF 002A0000 
Paged read/write 00000000.7BF50000 00000000. 7BF56FFF 002B0000 


KFD Device/Directory/Type: $31$DKB100:<SYS0.SYSCOMMON.SYSMSG>.EXE 


KFE Image Name/ KFERES Address/ File ID/ Flags/ 
Address Section Type Base End ImageOff 
829AE4FO DECCSMSG;1 (257,176,0) LIM Open HdrRes Shared 


This example shows the details for all images that match the wildcard DECC*. 
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SHOW LAN 


SHOW LAN 


Format 


Parameters 


Qualifiers 


Displays information contained in various local area network (LAN) data 
structures. 


SHOW LAN _[/qualifier{,...]] 


None. 


/ATM 
Specifies that asynchronous transfer mode (ATM) information for the LAN be 
displayed. 


/CLIENT=name 

Specifies that information be displayed for the specified client. Valid client 
designators are SCA, DECNET, LAT, MOPRC, TCPIP, DIAG, ELN, BIOS, LAST, 
USER, ARP, MOPDL, LOOP, BRIDGE, DNAME, ENCRY, DTIME, and LTM. 
The /CLIENT, /DEVICE, and /UNIT qualifiers are synonymous and mutually 
exclusive. 


/CLUEXIT 
Specifies that cluster protocol information be displayed. 


/COUNTERS 
Specifies that the LAN station block (LSB) and unit control block (UCB) counters 
be displayed. 


/CSMACD 

Specifies that Carrier Sense Multiple Access with Collision Detect (CSMA/CD) 
information for the LAN be displayed. By default, both CSMA/CD and Fiber 
Distributed Data Interface (FDDID information is displayed. 


/DEVICE=name 

Specifies that information be displayed for the specified device, unit, or client. For 
each LAN adapter on the system, there is one device and multiple users of that 
device called, units or clients. Device designators are specified in the format 
XXdn, where XX is the type of device, d is the device letter, and n is the unit 
number. The device letter and unit number are optional. The first unit, which 

is always present, is the template unit. These are specified as indicated in this 
example for a DEMNA called EX: 


/DEVICE=EX—display all EX devices on the system 
/DEVICE=EXA—display the first EX device only 
/DEVICE=EXA0—display the first EXA unit 
/DEVICE=SCA—display SCA unit 
/DEVICE=LAT—display LAT units 


Valid client names are listed in the /CLIENT=name qualifier. The /CLIENT, 
/DEVICE, and /UNIT qualifiers are synonymous and mutually exclusive. 
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SHOW LAN 


/ELAN 

Specifies information from an Emulated LAN (ELAN) that runs over an 
asynchronous transfer mode (ATM) network. The /ELAN qualifier displays 

the LAN Station Block (LSB) address, device state, and the LSB fields pertinent 
to an ELAN for both the parent ATM device and the ELAN pseudo-device drivers. 
It also specifies the name, description, parent device, state, and LAN emulation 
client (LEC) attributes of the ELAN. 


The qualifier /ELAN used with the device qualifier (ELAN/DEVICE=ELA) will 
only display information for the specified device or pseudo-device. 


/ERRORS 
Specifies that the LSB and UCB error counters be displayed. 


/FDDI 
Specifies that Fiber Distributed Data Interface (FDDI) information for the LAN 
be displayed. By default, both CSMA/CD and FDDI information is displayed. 


/FULL 
Specifies that all information from the LAN, LSB, and UCB data structures be 
displayed. 


ANTERNAL 

Specifies internal counters of the drivers by displaying the internal counters. If 
the /INTERNAL qualifier is used with the /DEVICE qualifier, the /INTERNAL 
specifies the internal counters of a specific driver. 


/QUEUES 

Specifies a listing of all queues, whether their status is valid or invalid, and all 
elements of the queues. If the (QUEUES qualifier is used with the /DEVICE 
qualifier, the /QUEUES specifies a specific queue. 


/SOURCEROUTING 
Specifies that the information in the source routing table maintained by the 
Token Ring driver be displayed. 


/SUMMARY 
Specifies that only a summary of LAN information (a list of flags, LSBs, UCBs, 
and base addresses) be printed. This is the default. 


/TIMESTAMPS 

Specifies that time information (such as start and stop times and error times) 
from the device and unit data structures be printed. SDA displays the data in 
chronological order. 


ITR 
Specifies that Token Ring information for the LAN be displayed. 


/UNIT=name 
Specifies that information be displayed for the specified unit. See the descriptions 
for /CLIENT=name and /DEVICE=name qualifiers. 


NCI 

Specifies that information be displayed for the VMS Communication Interface 
Block (VCIB) for each LAN device with an active VCI user. If you use the /VCI 
qualifier with the /DEVICE qualifier, the VCIB is only displayed for the specified 
device. 
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Description 


Examples 


SDA Commands 
SHOW LAN 


The SHOW LAN command displays information contained in various local area 
network (LAN) data structures. By default, or when the /SUMMARY qualifier is 
specified, SHOW LAN displays a list of flags, LSBs, UCBs, and base addresses. 
When the /FULL qualifier is specified, SHOW LAN displays all information found 


in the LAN, LSB, and UCB data structures. 


1. SDA> SHOW LAN/FULL 


LAN Data Structures 


-- LAN Information Summary 23-MAY-1996 13:07:52 -- 


LAN flags: 0000000 


LAN block address 
Number of stations 
LAN module version 
LANIDEF version 
LANUDEF version 
First LSB address 


4 LAN INIT 


80DB7140 
2 

1 

51 

26 
80DCA980 


Timer DELTA time 
DAT sequence number 
First SVAPTE 

Number of PTEs 

SVA of first page 


10000000 
1 
FFDF60F0 
3 
8183C000 


-- LAN CSMACD Network Management 23-MAY-1996 13:07:52 -- 


Creation time 
Deletion time 
Module EAB 
Port EAB 
Station EAB 


NM flags: 0000000 


-- LAN FDDI Network Management 23-MAY-1996 13:07:52 -- 


Creation time 
Deletion time 
Module EAB 
Port EAB 
Station EAB 


NM flags: 0000000 


LAN Data Structures 


None 
None 
00000000 
00000000 
00000000 
0 


None 
None 
00000000 
00000000 
00000000 
0 


Times created 
Times deleted 
Latest EIB 


Times created 
Times deleted 
Link EAB 

PHY port EAB 
Module EIB 


-- ESA Device Information 23-MAY-1996 13:07:52 -- 


LSB address 
Driver version 
Devicel version 
Device2 version 
LAN version 
Device name 

MOP ID 

HW version 
Controller mode 
Internal loopback 
Hardware address 
Physical address 
Active unit count 


Line speed 
Flags: 00000000 
Char: 00000000 


Status: 00000003 RU 


80DCA980 
00000001.07010037 
00000000.00000000 
00000000.00000000 
00000001.07010112 
EY NITC2 

~ 94 

00000000 

NORMAL 

OFF 
08-00-03-DE-00-12 
AA-00-04-00-88-FE 
1 

10 


N, INITED 


Driver code address 
Devicel code address 
Device2 code address 
LAN code address 

DLL type 

MOP name 

HW serial 
Promiscuous mode 
Promiscuous UCB 

All multicast state 
CRC generation mode 
Full Duplex Enable 
Full Duplex State 


Not 


0 
0 
00000000 


0 
0 
00000000 
00000000 
00000000 


80CAE838 
00000000 
00000000 
80CAFA00 
CSMACD 
MXE 
supplied 
OFF 
00000000 
OFF 

ON 

OFF 

OFF 
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SHOW LAN 


LAN Data Structures 


-- ESA Device Information (cont) 23-MAY-1996 13:07:52 -- 


Put rev ptr/index 00000000 
Put xmt ptr/index 80DCB620 
Put cmd ptr/index 00000000 
Put uns ptr/index 00000000 
Put smt ptr/index 00000000 
RBufs owned by dev 0 
XEnts owned by dev 0 
CEnts owned by dev 0 
UEnts owned by dev 0 
SEnts owned by dev 0 
Current rev buffers 17 
Rqst MAX rcv buffers 32 
Rqst MIN rcv buffers 16 
Curr MAX rcv buffers 32 
Curr MIN rcv buffers 16 
FILL rev buffers 16 
ADD rcv buffers 32 


LAN Data Structures 


Get rev ptr/index 00000015 
Get xmt ptr/index 80DCB620 
Get cmd ptr/index 00000000 
Get uns ptr/index 00000000 
Get smt ptr/index 00000000 
Rev packet limit 32 
XEnts owned by host 4 
Transmit timer 0 
Control timer 0 
Periodic SYSID timer 599 
Ring unavail timer 0 
USB timer 26 
Receive alignment 0 
Receive buffer size 1518 
Min lst chain segment 0 
Min transmit length 0 
Dev xmt header size 0 


-- ESA Device Information (cont) 23-MAY-1996 13:07:52 -- 


Last receive 23-MAY 13:07:51 


ADP address 80D4B280 
DAT stage 00000000 
DAT number started 1 
DAT number failed 0 
DAT VCRP 80DCBB80 
Mailbox enable flag 0 
CSR base phys addr 00000000.00000000 
Mailboxes in use 0 
2nd LW status flags 00000000 


LAN Data Structures 


23-MAY 13:07:50 
80DCA880 
0000003C.003C0001 
23-MAY 13:07:19 


Last transmit 
IDB address 

DAT xmt status 
DAT xmt complete 


DAT rcv found None 
DAT UCB 00000000 
CRAM read comman 00000000 
CRAM write comma 00000000 
Media UNDF 


-- ESA Network Management Information 23-MAY-1996 13:07:52 -- 


Creation time 
Deletion time 
Enabled time 
Disabled time 

EIB address 

LLB address 

LHB address 

First LPB address 


LAN Data Structures 


-- ESA Fork Information 


NM FKB time 
Fork status code 
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None 
None 
None 
None 
00000000 
00000000 
00000000 
00000000 


23-MAY 13:07:51 
23-MAY 13:07:51 
23-MAY 13:07:20 
23-MAY 13:07:20 
None 

None 

None 

None 

0 


Create count 0 
Enable count 0 
Number of ports 0 
Events logged 0 
NMgmt assigned addr None 
Station name itmlst 00000000 
Station itmlst len 0 
23-MAY-1996 13:07:52 -- 

ISR FKB in use flag FREE 
ISR FKB count 200 
IPL8 FKB in use flag FREE 
IPL8 FKB count 1 
RESET FKB in use flag FREE 
RESET FKB count 0 
NM FKB in use flag FREE 
NM FKB count 0 


LAN Data Structures 


SDA Commands 
SHOW LAN 


-- ESA Queue Information 23-MAY-1996 13:07:52 -- 


Control hold queue 
Control request queue 
Control pending queue 
Transmit request queue 
Transmit pending queue 
Receive buffer list 
Receive pending queue 
Post process queue 
Delay queue 

Auto restart queue 
Netwrk mgmt hold queue 


80DCACF0 
80DCACF8 
80DCAD00 
80DCACE8 
80DCAD18 
80DCAD38 
80DCAD20 
80DCAD08 
80DCAD10 
80DCAD28 
80DCAD30 


Status: 
Status: 
Status: 
Status: 
Status: 
Status: 
Status: 
Status: 
Status: 
Status: 
Status: 


Valid, 
Valid, 
Valid, 
Valid, 
Valid, 
Valid, 
Valid, 
Valid, 
Valid, 
Valid, 
Valid, 


empty 
empty 
empty 
empty 
empty 


17 elements 


empty 
empty 
empty 
empty 
empty 


-- ESA Multicast Address Information 23-MAY-1996 13:07:52 -- 


AB-00-00-04-00-00 


-- ESA Unit Summary 23-MAY-1996 13:07:52 -- 
State 


UCB UCB Addr Fmt 
ESAO 80D4F6C0 
ESA1 80E35400 Eth 


LAN Data Structures 


-- ESA Counters Information 23-MAY-1996 13:07:52 -- 


Octets received 

PDUs received 

Mcast octets received 
Mcast PDUs received 
Unrec indiv dest PDUs 
Unrec mcast dest PDUs 
Data overruns 

Unavail station buffs 
Unavail user buffers 
CRC errors 

Alignment errors 

Rev data length err 
Frame size errors 
Frames too long 
Seconds since zeroed 
Station failures 


Value 


60-03 


596 


uo 
\o 
ac 


Ww 
oPoqcoqooooor oo & 


Client 


DECNET 0017 STRIN,LEN,UNIQ,STRTD 


Octets sent 

PDUs sent 

Mcast octets sent 
Mcast PDUs sent 

PDUs sent, deferred 
PDUs sent, one coll 
PDUs sent, mul coll 
Excessive collisions 
Late collisions 
Carrier check failure 
Last carrier failure 
Coll detect chk fail 
Short circuit failure 
Open circuit failure 
Transmits too long 
Send data length err 


ray 
w 
ou 


Non 


oooouwngjqoococcoCcoCOw 
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SHOW LAN 


LAN Data Structures 


-- ESA Counters 


oO 


No work transmits 

Buffer Addr transmits 
SVAPTE/BOFF transmits 
Global page transmits 


Bad PTE transmits 
Restart pending cou 
+00 MCA not enabled 
+04 Xmt underflows 
+08 Rev overflows 
+0C Memory errors 
+10 Babbling errors 
+14 Local buffer er 
+18 LANCE interrupt 
+1C Xmt ring <31:0> 
+20 Xmt ring <63:32 
+24 Soft errors han 
+28 Generic (or unu 


Data Structures 


-- ESA Error Information 23-MAY-1996 13:07:52 -- 


nter 


ray 
co 
oooonoc;*cocoeo 


oOo 


rors 
s 202 

00000000 
> 00000000 
dled 0 
sed) 00000000 


Fatal error count 0 
Fatal error code None 
Prev error code None 
Transmit timeouts 0 
Control timeouts 0 
Restart failures 0 
Power failures 0 
Bad PTE transmits 0 
Loopback failures 0 
System ID failures 0 
ReqCounters failures 0 


LAN Data Structures 


Ring avail transitions 
Ring unavail transitions 
Loopback sent 

System ID sent 
RegqCounters sent 
Internal counters size 
+2C Generic (or unused) 
+30 Generic (or unused) 
+34 Generic (or unused) 
+38 Generic (or unused) 
+3C Generic (or unused) 
+40 Generic (or unused) 
+44 Generic (or unused) 
+48 Generic (or unused) 
+4C Generic (or unused) 
+50 Generic (or unused) 
+54 Generic (or unused) 


error CSR 
fatal error 
fatal error 
USB time 
UUB time 
CRC time 
CRC srcadr 
length erro 
exc collisi 
carrier fal 
late collis 


Last 
Last 
Prev 
Last 
Last 
Last 
Last 
Last 
Last 
Last 
Last 


Information (cont) 23-MAY-1996 13:07:52 -- 


2. oa 4 


0 

40 
00000000 
00000000 
00000000 
80DCAD18 
80DCAD18 
004E0840 
61616161 
61616161 
61616161 
61616161 
61616161 


00000000 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 


-- ESAQ Template Unit Information 23-MAY-1996 13:07:52 -- 


LSB address 80DCA980 
VCIB address 00000000 
Stop IRP address 00000000 
Restart IRP address 00000000 
LAN medium CSMACD 
Packet format Ethernet 
Eth protocol type 00-00 
802E protocol ID 00-00-00-00-00 
802.2 SAP 00 
802.2 Group SAPs 00,00,00,00 
Controller mode NORMAL 
Internal loopback OFF 
CRC generation mode ON 
Functional Addr mod ON 


Hardware address 
Physical address 
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08-00-03-DE-00-12 


FF-FF-FF-FF-FF-FF 


Error count 
Parameter mask 
Promiscuous mode 
All multicast mode 
Source Routing mode 
Access mode 

Shared user DES 
Padding mode 
Automatic restart 
Allow prom client 
Can change address 
802.2 service 

Rev buffers to save 
Minimum rcv buffers 
User transmit FC/AC 
User receive FC/AC 


0 
00000000 
OFF 

OFF 
TRANSPARENT 
EXCLUSIVE 
None 

ON 
DISABLED 
ON 

OFF 

User 

1 

4 

ON 

OFF 


LAN Data Structures 


SDA Commands 
SHOW LAN 


-- ESAl 60-03 (DECNET) Unit Information 23-MAY-1996 13:07:52 -- 


LSB address 80DCA980 
VCIB address 00000000 
Stop IRP address 80E047C0 
Restart IRP address 00000000 
LAN medium CSMACD 
Packet format Ethernet 
Eth protocol type 60-03 


802E protocol ID 00-00-00-00-00 
802.2 SAP 00 


802.2 Group SAPs 00,00,00,00 
Controller mode NORMAL 
Internal loopback OFF 
CRC generation mode ON 
Functional Addr mod ON 


08-00-03-DE-00-12 
AA-00-04-00-88-FE 


Hardware address 
Physical address 


LAN Data Structures 


Error count 0 
Parameter mask 00DA8695 
Promiscuous mode OFF 
All multicast mode OFF 
Source Routing mode TRANSPARENT 
Access mode EXCLUSIVE 
Shared user DES None 
Padding mode ON 
Automatic restart DISABLED 
Allow prom client ON 
Can change address OFF 
802.2 service User 
Rev buffers to save 10 
Minimum rcv buffers 4 
User transmit FC/AC ON 
User receive FC/AC OFF 


-- ESAl 60-03 (DECNET) Unit Information (cont) 23-MAY-1996 13:07:52 -- 


23-MAY 13:07:47 
23-MAY 13:07:50 
23-MAY 13:07:20 


Last receive 

Last transmit 

Last start attempt 
Last start done 23-MAY 13:07:20 
Last start failed None 
MCA match enabled 01 
Last MCA filtered AB-00-00-04-00-00 


UCB status: 


Receive IRP queue 
Receive pending queue 


Multicast address table, embedded: 
AB-00-00-04-00-00 


LAN Data Structures 


Starter’s PID 0001000F 
Maximum header size 16 
Maximum buffer size 1498 
Rev quota charged 15040 
Default FC value 00 
Default AC value 00 
Maintenance state ON 


00000017 STRTN, LEN, UNIO, STRTD 


80E356E8 Status: 
80E356E0 Status: 


Valid, 1 element 
Valid, empty 


-- ESAl 60-03 (DECNET) Counters Information 23-MAY-1996 13:07:52 -- 


Octets received 483 
PDUs received 7 
Mcast octets received 483 
Mcast PDUs received 7 
Unavail user buffer 0 


Last UUB time None 


Octets sent 180 
PDUs sent 3 
Mcast octets sent 180 
Mcast PDUs sent 3 
Multicast not enabled 0 
User buffer too small 0 


The SHOW LAN/FULL command displays information for all LAN, LSB, and 


UCB data structures. 
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2. SDA> SHOW LAN/TIME 
-- LAN History Information 12-FEB-1995 11:08:48 -- 


12-FEB 11:08:47.92 ESA Last receive 

12-FEB 11:08:47.92 ESA Last fork scheduled 
12-FEB 11:08:47.92 ESA Last fork time 

12-FEB 11:08:47.77 ESAS LAST Last receive 

12-FEB 11:08:47.72 ESA3 LAT Last receive 

12-FEB 11:08:41.25 ESA Last transmit 

12-FEB 11:08:41.25 ESA5 LAST Last transmit 

12-FEB 11:08:40.02 ESA2 DECnet Last receive 

12-FEB 11:08:39.14 ESA2 DECnet Last transmit 

12-FEB 11:08:37.39 ESA3 LAT Last transmit 

12-FEB 10:19:25.31 ESA Last unavail user buffer 
12-FEB 10:19:25.31 ESA2 DECnet Last unavail user buffer 
11-FEB 14:10:20.09 ESA5 LAST Last start completed 
11-FEB 14:10:02.16 ESA3 LAT Last start completed 
11-FEB 14:09:58.44 ESA2 DECnet Last start completed 
11-FEB 14:09:57.44 ESA Last DAT transmit 


The SHOW LAN/TIME command displays print time information from device 
and unit data structures. 


3. SDA> SHOW LAN/VCI/DEVICE=ICB 
-- ICB VCI Information 17-APR-1996 14:22:07 -- 


LSB address 80A1D580 
Device state = 00000003 RUN, INITED 


-- ICB2 80-41 (LAST) VCI Information 17-APR-1996 14:22:07 -- 


VCIB address = 8096F238 

CLIENT flags: 00000001 RCV DCB 

LAN flags: 00000004 LAN INIT 

DLL flags: 00000005 XMT CHAIN, PORT STATUS 

UCB status: 00000015 STRTN, UNIO, STRTD 

VCI ID LAST VCI version 00010001 

UCB address 80A4C5C0 DP VCRP address 00000000 

Hardware address 00-00-93-08-52-CF LDC address 80A1D720 

Physical address 00-00-93-08-52-CF LAN medium TR 

Transmit available 80A1D670 Outstanding operations 0 

Maximum receives 0 Outstanding receives 0 

Max xmt size 4444 Header size 52 

Build header rtn 808BF230 Report event rtn 86327130 

XMT initiate rtn 808BF200 Transmit complete rtn 86326D80 

XMT frame rtn 808BF210 Receive complete rtn 86326A80 
-- ICB2 80-41 (LAST) VCI Information (cont) 17-APR-1996 14:22:07 -- 

Portmgmt initiate rtn 808BF0C0 Portmgmt complete rtn 86327100 

Monitor request rtn 00000000 Monitor transmit rtn 00000000 

Monitor flags 00000000 Monitor receive rtn 00000000 

Port usable 00000000 Port unusable 00000000 


The SHOW LAN/VCI/DEVICE=ICB command displays the VCIB for a Token 
Ring device (ICB) that has an active VCI user (LAST). 
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SDA> SHOW LAN/ELAN 
-- HCA Emulated LAN LSB Information 17-APR-1996 14:08:02 -- 


LSB address = 8098D200 
Device state = 00000101 RUN,RING AVAIL 


Driver CM VC setup adr 808986A0 Driver CM VC teardown adr 80898668 


NIPG CM handle adr 8096C30C NIPG CM SVC handle 00000000 
NIPG CM agent handle adr 809B364C NIPG CM mgr lineup handle 809B394C 
NIPG CM ILMI IO handle 809B378C MIB II handle adr 809B94CC 
MIB handle adr 809B3ACC Queue header for EL LSBs 00000000 
DEC MIB handle adr 809BBD8C NIPG current TQEs used 00000000 
Count of allocated TQEs 0000000D NIPG current pool used 0000D2c0 


NIPG pool allocations 00075730 
-- ELA Emulated LAN LSB Information 17-APR-1996 14:08:02 -- 


LSB address = 80AB08C0 
Device state = 00000001 RUN 


ELAN name = ELAN 1 
ELAN description = ATM ELAN 
ELAN parent = HCA0 
ELAN state = 00000001 ACTIVE 


MAX transmit size MTU 1516 ELAN media type LAN 802 3 
LEC attr buff adr 80AB1FCO LEC attr buff size 00000328 
Event mask 00000000 Pvc identifer 00000000 
Extended sense 00000000 

-- ELA Emulated LAN LEC Attributes 17-APR-1996 14:08:02 -- 
LAN type 00000000 LAN MTU 00000001 
Proxy flag 00000000 Control timeout 0000000A 
Max UF count 00000001 Max UF time 00000001 
Vcc timeout 000004B0 Max retry count 00000002 
LEC id 00000002 Forw delay time 0000000F 
Flush timeout 00000004 Path switch delay 00000006 
SM state 00000070 Illegal CTRL frames 00000000 
CTRL xmt failures 00000000 CTRL frames sent 0000000C 
CTRL frames revd 00000012 LEARPs sent 00000000 
LEARPS rcvd_ 00000000 UCASTs sent direct 00000000 
UCASTs flooded 00000006 UCASTs discarded 00000001 
NUCASTs sent 00000000 
Local ESI 00000000.00000000 
BUS ATM addr 3999990000000008002BA57E80.AA000302FF12.00 
LES ATM addr 3999990000000008002BA57E80.AA000302FF14.00 
My ATM addr 3999990000000008002BA57E80.08002B2240A0.00 


The SHOW LAN/ELAN command displays information for the parent ATM 
device (HCA) driver and the ELAN pseudo-device (ELA) driver. 
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5. SDA> SHOW LAN/ELAN/DEV=ELA 
-- ELA Emulated LAN LSB Information 17-APR-1996 14:08:22 -- 


LSB address = 80AB08C0 
Device state = 00000001 RUN 


ELAN name = ELAN 1 
ELAN description = ATM ELAN 
ELAN parent = HCA0 
ELAN state = 00000001 ACTIVE 


MAX transmit size MTU 1516 ELAN media type LAN_802_3 
LEC attr buff adr 80AB1FCO LEC attr buff size 00000328 
Event mask 00000000 PVC identifer 00000000 
Extended sense 00000000 

-- ELA Emulated LAN LEC Attributes 17-APR-1996 14:08:22 -- 
LAN type 00000000 LAN MTU 00000001 
Proxy flag 00000000 Control timeout 0000000A 
Max UF count 00000001 Max UF time 00000001 
VCC timeout 000004B0 Max retry count 00000002 
LEC id 00000002 Forw delay time 0000000F 
Flush timeout 00000004 Path switch delay 00000006 
SM state 00000070 Illegal CTRL frames 00000000 
CTRL xmt failures 00000000 CTRL frames sent 0000000C 
CTRL frames rcvd 00000012 LEARPs sent 00000000 
LEARPS rcvd_ 00000000 UCASTs sent direct 00000000 
UCASTs flooded 00000006 UCASTs discarded 00000001 
NUCASTs sent 00000000 
Local ESI 00000000.00000000 
BUS ATM addr 3999990000000008002BA57E80.AA000302FF12.00 
LES ATM addr 3999990000000008002BA57E80.AA000302FF14.00 
My ATM addr 3999990000000008002BA57E80.08002B2240A0.00 


The SHOW LAN/ELAN/DEVICE=ELA command displays information for the 
ELAN pseudo-device (ELA) driver only. 


6. SDA> SHOW LAN/ELAN/DEVICE=HCA 
-- HCA Emulated LAN LSB Information 17-APR-1996 14:08:25 -- 


LSB address = 8098D200 
Device state = 00000101 RUN,RING AVAIL 


Driver CM VC setup adr 808986A0 Driver CM VC teardown adr 80898668 


NIPG CM handle adr 8096C30C NIPG CM SVC handle 00000000 
NIPG CM agent handle adr 809B364C NIPG CM mgr lineup handle 809B394C 
NIPG CM ILMI IO handle 809B378C MIB II handle adr 809B94CC 
MIB handle adr 809B3ACC Queue header for EL LSBs 00000000 
DEC MIB handle adr 809BBD8C NIPG current TQEs used 00000000 
Count of allocated TOQEs 0000000D NIPG current pool used 0000D2Cc0 


NIPG pool allocations 000757B2 


The SHOW LAN/ELAN/DEVICE=HCA command displays information for the 
ATM device (HCA) driver only. 
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SHOW LOCKS 


Format 


Parameter 


Qualifiers 


Displays information about all lock management locks in the system, or about a 
specified lock. 


SHOW LOCKS _ {lock-id|/ADDRESS=n1/ALL (d)| 
/BLOCKING |/BRIEF |/CACHED |/CONVERT |/GRANTED 
|/NAME=name |/POOL | 
/STATUS=(keyword [,keyword...]) |/SUMMARY | 
/WAITING} 


lock-id 
Name of a specific lock. 


/ADDRESS=n 
Displays a specific lock, given the address of the lock block. 


/ALL 
Lists all locks that exist in the system. This is the default behavior of the SHOW 
LOCKS command. 


/BLOCKING 
Displays only the locks that have a blocking AST specified or attached. 


/BRIEF 
Displays a single line of information for each lock. 


/CACHED 

Displays locks that are no longer valid. The memory for these locks is saved so 
that later requests for locks can use them. Cached locks are not displayed in the 
other SHOW LOCKS commands. 


/CONVERT 
Displays only the locks that are on the conversion queue. 


/GRANTED 
Displays only the locks that are on the granted queue. 


/NAME=name 

Displays all locks on the specified resource. Name can be the actual name of the 
resource, if it only contains uppercase letters, numerals, the underscore (_), dollar 
sign, colon (:), and some other printable characters, as for example, /NAME=MY_ 
LOCK. If it contains other printable characters (including lowercase letters), 

you may need to enclose the name in quotation marks (""), as for example, 
/NAME="My_Lock/47". If it contains nonprintable characters, you can specify the 
name as a comma-separated list comprised of strings and hexadecimal numbers. 
For example, /NAME=("My_Lock",0C00,"/47") would specify the name "My_ 
Lock<NUL><FF>/47". The hexadecimal number can be no more than 8 digits (4 
bytes) in length. Nonprintable sequences of more than 4 bytes must be split into 
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multiple hexadecimal numbers. The maximum length of a resource name is 32 
characters. 


/POOL 
Displays the lock manager’s poolzone information, which contains the lock blocks 
(LKB) and resource blocks (RSB). 


/STATUS=(keyword[,keyword...]) 
Displays only the locks that have the specified status bits set in the LKB$L_ 
STATUS field. Status keywords are as follows: 


Keyword Meaning 

2PC_IP Indicates a two-phase operation in progress 
2PC_PEND Indicates a two-phase operation pending 
ASYNC Completes request asynchronously 
BLKASTFLG Specifies a blocking AST 

BLKASTQED Indicates a blocking AST is queued 
BRL Indicates a byte range lock 

CACHED Indicates a lock block in cache 
CVTSUBRNG Indicates a sub-range convert request 
CVTTOSYS Converts back to system-owned lock 
DBLKAST Delivers a blocking AST 

DCPLAST Delivers a completion AST 

DPC Indicates a delete pending cache lock 
FLOCK Indicates a fork lock 

GRSUBRNG Grants sub-range lock 

IP Indicates operation in process 

MSTCPY Indicates a lock block is a master copy 
NEWSUBRNG Indicates a new sub-range request 
NOQUOTA Does not charge quota 

PCACHED Indicates lock block needs to be cached 
PROTECT Indicates a protected lock 

RESEND Resends during failover 

RM_RBRQD Requires remaster rebuild 

RNGBLK Specifies a range block 

RNGCHG Indicates a changing range 

TIMOUTQ Indicates lock block is on timeout queue 
VALBLKRD Indicates read access to lock value block 
VALBLKWRT Indicates write access to lock value block 
WASSYSOWN Indicates was system-owned lock 
/SUMMARY 


Displays summary data and performance counters. 


NWAITING 


Displays only the waiting locks. 
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The SHOW LOCKS command displays the information described in Table 4—6 for 
each lock management lock in the system, or for the lock indicated by lock-id, an 
address or name. (Use the SHOW SPINLOCKS command to display information 
about spinlocks.) You can obtain a similar display for the locks owned by a 
specific process by issuing the appropriate SHOW PROCESS/LOCKS command. 
See the HP OpenVMS Programming Concepts Manual for additional information. 


You can display information about the resource to which a lock is queued by 
issuing the SHOW RESOURCES command specifying the resource’s lock-id. 


Table 4-6 Contents of the SHOW LOCKS and SHOW PROCESS/LOCKS 
Displays 


Display Element Description 


Process Index! 


Name! 


Extended PID! 


Index in the PCB array to a pointer to the process 
control block (PCB) of the process that owns the lock. 


Name of the process that owns the lock. 


Clusterwide identification of the process that owns the 
lock. 


Lock ID Identification of the lock. 

PID Systemwide identification of the lock. 

Flags Information specified in the request for the lock. 

Par. ID Identification of the lock’s parent lock. 

Sublocks Count of the locks that the lock owns. 

LKB Address of the lock block (LKB). If a blocking AST 
has been enabled for this lock, the notation “BLKAST” 
appears next to the LKB address. 

Priority The lock priority. 

Granted at Lock mode at which the lock was granted. 

RSB Address of the resource block. 

Resource Dump of the resource name. The two leftmost columns 
of the dump show its contents as hexadecimal values, 
the least significant byte being represented by the 
rightmost two digits. The rightmost column represents 
its contents as ASCII text, the least significant byte 
being represented by the leftmost character. 

Status Status of the lock, information used internally by the 
lock manager. 

Length Length of the resource name. 

Mode Processor access mode of the namespace in which the 


resource block (RSB) associated with the lock resides. 


1This display element is produced only by the SHOW PROCESS/LOCKS command. 


(continued on next page) 
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Table 4-6 (Cont.) Contents of the SHOW LOCKS and SHOW PROCESS/LOCKS 
Displays 


Display Element Description 


Owner Owner of the resource. Certain resources owned by the 
operating system list “System” as the owner. Resources 
owned by a group have the number (in octal) of the 
owning group in this field. 

Copy Indication of whether the lock is mastered on the local 


system or is a process copy. 


Examples 


1. SDA> SHOW LOCKS 


Lock Database 


Lock id: 3E000002 PID: 00000000 Flags: CONVERT NOQUEUE SYNCSTS 
Par. id: 00000000 SUBLCKs: 0 NOQUOTA CVTSYS 
LKB: FFFFFFFF.7DF48150 BLKAST: 81107278 
Priority: 0000 
Granted at CR 00000000-FFFFFFFF 
RSB: FFFFFFFF.7DF68D50 
Resource: 494D6224 42313146 FI11BSbMI Status: NOQUOTA VALBLKR VALBLKW 
Length 18 4D55445F 5944414C LADY DUM 

Kernel mode 00000000 00005350 PS...... 

System 00000000 00000000 ........ 
Local copy 
Lock Database 
Lock id: 3F000003 PID: 00000000 Flags: VALBLK CONVERT SYNCSTS 
Par. id: 0100007A SUBLCKs: 0 CVTSYS 
LKB: FFFFFFFF.7DF48250 BLKAST: 00000000 
Priority: 0000 
Granted at NL 00000000-FFFFFFFF 
RSB: FFFFFFFF.7DF51D50 
Resource: 01F77324 42313146 F11BSs+ Status: NOQUOTA VALBLKR VALBLKW 
Length 10 00000000 00000000 ........ 

Kernel mode 00000000 00000000 ........ 

System 00000000 00000000 ........ 
Local copy 
Lock Database 
Lock id: 0A000004 PID: 0001000F Flags: VALBLK CONVERT SYNCSTS 
Par. id: 00000000 SUBLCKs: 0 SYSTEM NODLCKW NODLCKB 
LKB: FFFFFFFF.7DF48350 BLKAST: 81190420 QUECVT 
Priority: 0000 
Granted at EX 00000000-FFFFFFFF 
RSB: FFFFFFFF.7DF50850 
Resource: OO04FOFDF 24534D52 RMSSB.O. Status: VALBLKR VALBLKW 

Length 26 5F313039 58020000 ...X901_ 

Exec. mode 00202020 204C354B K5L 7 

System 00000000 00000000 ........ 


4-140 SDA Commands 


SDA Commands 
SHOW LOCKS 


Local copy 


2. SDA> SHOW RESOURCES/LOCKID=0A000004 


Resource Database 


RSB: FFFFFFFF.7DF50850 GGMODE: EX Status: DIRENTR VALID 

Parent RSB: 00000000.00000000 CGMODE: EX 

Sub-RSB count: 0 FGMODE: EX 

Lock Count: 1 RQSEQNM: 0000 

BLKAST count: 1 CSID: 00000000 (MILADY) 

Resource: QO4FOFDF 24534D52 RMSSB.O. Valblk: 00000000 00000000 
Length 26 5F313039 58020000 ...X901 00000000 00000000 
Exec. mode 00202020 204C354B K5L . 

System 00000000 00000000 ........ Seqnum: 00000000 


Granted queue (Lock ID / Gr mode / Range): 
0A000004 EX 00000000-FFFFFFFF 


Conversion queue (Lock ID / Gr mode / Range -> Rq mode / Range): 
*** EMPTY QUEUE *** 


Waiting queue (Lock ID / Rq mode / Range): 
*** EMPTY QUEUE *** 


This SDA session shows the output of the SHOW LOCKS command for several 
locks. The SHOW RESOURCES command, executed for the last displayed lock, 
verifies that the lock is in the resource’s granted queue. (See Table 4—25 for a full 
explanation of the contents of the display of the SHOW RESOURCES command.) 


3. SDA> SHOW LOCK/BRIEF/BLOCKING 


Lock Database 

LKB Address Lockid ParentId PID BLKAST SubLocks RQ GR Queue RSB Address Resource Name Mode 
FFFFFFFF.7FF42450 51000003 00000000 00000000 80CC7648 CR Granted FFFFFFFF.7FF45050 F11B$bSWPCTX_DUMPS Kern 
FFFFFFFF.7FF42850 01000005 00000000 00000000 80CB5020 11 CR Granted FFFFFFFF.7FF42950 F11B$vx6JU_R3N Kern 
FFFFFFFF.7FF42A50 01000006 00000000 00000000 80CD3D98 PR Granted FFFFFFFF.7FF42B50 VCC$vX6JU_R3N Kern 
FFFFFFFF.7FF42E50 4D000008 00000000 00000000 80CC7648 CR Granted FFFFFFFF.7FF43150 F11B$bx6JU_R3N Kern 
FFFFFFFF.7FF43E50 13000010 00000000 00000000 80CD3D98 PR Granted FFFFFFFF.7FF53D50 VCC$vSWPCTX_DUMPS Kern 
FFFFFFFF.7FF48750 12000033 03000094 00010008 80CE7220 PW Granted FFFFFFFF.7FF48E50 APPENDER Exec 
FFFFFFFF.7FF49550 1500003A 00000000 00010008 00010B20 CR Granted FFFFFFFF.7FF54E50 AUDRSVS$DJ...... X6JU_R3N ee. User 
FFFFFFFF.7FF49B50 1300003D 00000000 00010007 00035EF8 CR Granted FFFFFFFF.7FF56250 OPCS$opcom-restart User 
FFFFFFFF.7FF4BE50 2100004F 00000000 0001000B 80CE66F0 NL Granted FFFFFFFF.7FF4DC50 RMSSy...... X6JU_R3N wee Exec 
FFFFFFFF.7FF4C950 13000054 00000000 0001000B 80CE66F0 EX Granted FFFFFFFF.7FF4CE50 RMS$8.0....X6JU_R3N Seed Exec 
FFFFFFFF.7FF4E050 0BO0005F 00000000 00010009 80CE66F0 NL Granted FFFFFFFF.7FF4AD50 RMSSE£...... X6JU_R3N sieve Exec 
FFFFFFFF.7FF4EA50 0C000064 00000000 00010007 00035F30 CR Granted FFFFFFFF.7FF56150 OPCS$opcom-abort User 
FFFFFFFF.7FF51350 18000078 00000000 00010011 0000B930 PR Granted FFFFFFFF.7FF44E50 NETSNETPROXY_MODIFIED Kern 
FFFFFFFF.7FF52850 0C000082 00000000 00000000 80CB5020 Granted FFFFFFFF.7FF43550 F11B$vSWPCTX_DUMPS Kern 
FFFFFFFF.7FF53250 09000087 00000000 00010008 80CE66F0 EX Granted FFFFFFFF.7FF49850 RMSS$J...... X6JU_R3N abe Exec 
FFFFFFFF.7FF46C50 2700008E 00000000 0001000A 80CE66F0 EX Granted FFFFFFFF.7FF53750 RMSS....... X6JU_R3N aie Exec 
FFFFFFFF.7FF54750 03000094 00000000 00010008 80CE66F0 EX Granted FFFFFFFF.7FF4A950 RMSSK...... X6JU_R3N aia Exec 
FFFFFFFF.7FF54B50 04000098 10000042 00010008 00011358 CR Granted FFFFFFFF.7FF55050 WRITER User 
FFFFFFFF.7FF54D50 05000099 11000047 00010009 00010F48 PR Granted FFFFFFFF.7FF56F50 JBC$_CHECK_DB User 
FFFFFFFF.7FF55150 0100009A 10000042 00010008 000112E0 CR Granted FFFFFFFF.7FF55250 DOORBELL User 
FFFFFFFF.7FF55350 0200009B 00000000 00010008 00010B20 CR Granted FFFFFFFF.7FF55450 AUDRSVSDK...... X6JU_R3N ».. User 
FFFFFFFF.7FF55550 0200009C 00000000 00010008 80CE66F0 EX Granted FFFFFFFF.7FF55850 RMSSL...... X6JU_R3N ee Exec 
FFFFFFFF.7FF55D50 020000A0 00000000 00010008 000123E0 CR Granted FFFFFFFF.7FF55C50 AUDRSVSOL...... X6JU_R3N ees User 
FFFFFFFF.7FF57250 040000A9 00000000 0001000A 80CE66F0 EX Granted FFFFFFFF.7FF4AD50 RMSSE£...... X6JU_R3N Sacs Exec 
FFFFFFFF.7FF57A50 030000AF 110000AA 0001000A 00012628 PR Granted FFFFFFFF.7FF57D50 QMANSREF........ User 
FFFFFFFF.7FF58150 010000B2 110000AA 0001000A 000109C0 PR Granted FFFFFFFF.7FF58050 QMANSNEW_JOBCTL User 
FFFFFFFF.7FF58E50 050000B9 110000AA 0001000A 000147F8 PR Granted FFFFFFFF.7FF58F50 QMANSMASTER_QUEUES User 


SSOONSDNDCCONNKBOCOROROCOCOCOCOCOHSG 
Q 
nw 
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This example shows the brief display for all locks with a blocking AST. 
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SHOW MACHINE_CHECK 


Format 


Parameter 


Qualifier 


Description 


Displays the contents of the stored machine check frame. This command is valid 
for the DEC 4000 Alpha, DEC 7000 Alpha, and DEC 10000 Alpha computers only. 


SHOW MACHINE_CHECK _ [/FULL] [cpu-id] 


cpu-id 

Numeric value from 00 to 1F jg indicating the identity of the CPU for which 
context information is to be displayed. This parameter changes the SDA current 
CPU (the default) to the CPU specified with cpu-id. If you specify a value outside 
this range, or you specify the cpu-id of a processor that was not active at the 
time of the system failure, SDA displays the following message: 


$SDA-E-CPUNOTVLD, CPU not booted or CPU number out of range 


If you use the cpu-id parameter, the SHOW MACHINE CHECK command 
performs an implicit SET CPU command, making the CPU indicated by cpu-id 
the current CPU for subsequent SDA commands. (See the description of the SET 
CPU command and Section 2.5 for information on how this can affect the CPU 
context—and process context—in which SDA commands execute.) 


/FULL 
Specifies that a detailed version of the machine check information be displayed. 
This is currently identical to the default summary display. 


The SHOW MACHINE_CHECK command displays the contents of the stored 
machine check frame. A separate frame is allocated at boot time for every CPU 
in a multiple-CPU system. This command is valid for the DEC 4000 Alpha, DEC 
7000 Alpha, and DEC 10000 Alpha computers only. 


If you do not specify a qualifier, a summary version of the machine check frame is 
displayed. 


The default cpu-id is the SDA current CPU. 
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Examples 


1. SDA> SHOW MACHINE CHECK 
CPU 00 Stored Machine Check Crash Data 


Exception address: FFFFFFFF.800B0250 Exception Summary: 00000000.00000000 


Pal base address: 00000000.00008000 Exception Mask: 00000000.00000000 
HW Interrupt Request: 00000000.00000342 HW Interrupt Ena: 00000001.FFCO1CE0 
MM CSR 00000000.00003640 ICCSR: 00000002.381F0000 
D-cache address: 00000007. FFFFFFFF D-cache status: 00000000.000002E0 
BIU status: 00000000.00000050 BIU address [7..0]: 00000000.000060E0 
BIU control: 00000008.50006447 Fill Address: 00000000.00006120 
Single-bit syndrome: 00000000.00000000 Processor mchck VA: 00000000.00006190 
A-box control: 00000000.0000040E B-cache TAG: 00106100.83008828 


System specific information: 


Garbage bus info: 00200009 00000038 Device type: 000B8001 
LCNR: 00000001 Memory error: 00000000 
LBER: 00000009 Bus error synd 0,1: 00000000 00000000 
Bus error cmd: 00048858 00AB1C88 Bus error synd 2,3: 00000000 0000002C 
LEP mode: 00010010 LEP lock address: 00041108 


The SHOW MACHINE_CHECK command in this SDA display shows the contents 
of the stored machine check frame. 


2. SDA> SHOW MACHINE CHECK 1 
CPU 01 Stored Machine Check Crash Data 


Exception address: FFFFFFFF .800868A0 Exception Summary: 00000000.00000000 
Pal base address: 00000000.00008000 Exception Mask: 00000000.00000000 
HW Interrupt Request: 00000000.00000342 HW Interrupt Ena: 00000000.1FFE1CE0 
MM CSR 00000000.00005BF1 ICCSR: 00000000.081F0000 
D-cache address: 00000007. FFFFFFFF D-cache status: 00000000.000002E0 
BIU status: 00000000.00000050 BIU address [7..0]: 00000000.000063E0 
BIU control: 00000008.50006447 Fill Address: 00000000.00006420 
Single-bit syndrome: 00000000.00000000 Processor mchck VA: 00000000.00006490 
A-box control: 00000000.0000040E B-cache TAG: 35028EA0 . 50833828 


System specific information: 


Garbage bus info: 00210001 00000038 Device type: 000B8001 
LCNR: 00000001 Memory error: 00000080 
LBER: 00040209 Bus error synd 0,1: 00000000 00000000 
Bus error cmd: 00048858 O0AB1C88 Bus error synd 2,3: 00000000 0000002C 
LEP mode: 00010010 LEP lock address: 00041108 


The SHOW MACHINE_CHECK command in this SDA display shows the contents 
of the stored machine check frame for cpu-id 01. 
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SHOW MEMORY 


Format 


Parameters 


Qualifiers 


Displays the availability and usage of memory resources. 


SHOW MEMORY [/ALL][/BUFFER_OBJECTS][/CACHE]|[/FILES] 
[/FULL][/GH_REGIONS]|/PHYSICAL_PAGES]|/POOL] 
[/RESERVED][/SLOTS] 


None. 


/ALL 
Displays all available information, that is, information displayed by the following 
qualifiers: 


/BUFFER_OBJECTS 
/CACHE 

/FILES 
/GH_REGIONS 
/PHYSICAL_PAGES 
/POOL 

/RESERVED 
/SLOTS 


This is the default display. 


/BUFFER_OBJECTS 
Displays information about system resources used by buffer objects. 


ICACHE 

Displays information about either the Virtual I/O Cache facility or the Extended 
File Cache facility. The system parameter VCC_FLAGS determines which is 
used. The cache facility information is displayed as part of the SHOW MEMORY 
and SHOW MEMORY/CACHE/FULL commands. 


/FILES 
Displays information about the use of each paging and swapping file currently 
installed. 


/FULL 

Displays additional information about each pool area when used with the /POOL 
qualifier. This qualifier is ignored unless you specify the /POOL qualifier. When 
used with the /CACHE qualifier, /FULL displays additional information about the 
use of the Virtual I/O Cache facility, but is ignored if the Extended File Cache 
facility is in use. 


/GH_REGIONS 

Displays information about the granularity hint regions (GHR) that have been 
established. For each of these regions, information is displayed about the size 
of the region, the amount of free memory, the amount of memory in use, and 
the amount of memory released to OpenVMS from the region. The granularity 
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hint regions information is also displayed as part of SHOW MEMORY, SHOW 
MEMORY/ALL, and SHOW MEMORY/FULL commands. 


/PHYSICAL_PAGES 
Displays information about the amount of physical memory and the number of 
free and modified pages. 


/POOL 

Displays information about the usage of each dynamic memory (pool) area, 
including the amount of free space and the size of the largest contiguous block in 
each area. 


/RESERVED 
Displays information about memory reservations. 


/SLOTS 
Displays information about the availability of partition control block (PCB) vector 
slots and balance slots. 


For more information about the SHOW MEMORY command, see the description 
in the HP OpenVMS DCL Dictionary: N-Z. 
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SHOW PAGE_TABLE 


Displays a range of system page table entries, the entire system page table, or 
the entire global page table. 


Format 


SHOW PAGE_TABLE  {rangel/FREE [/HEADER=address] 
| /GLOBALI/GPT | /PT 
| /INVALID_PEN [=option] 
|/NONMEMORY_PEN [=option] 
| /PTE_ADDRESS1/SECTION_INDEX=n 
I/SOS1 (d)1/S21/SPTW1=ALL} 
VILA L/L21/L3 (d)} 


Parameter 


range 

Range of virtual addresses or PTE addresses for which SDA displays page table 
entries. If the qualifier /PTE_ADDRESS is given, then the range is of PTE 
addresses; otherwise, the range is of virtual addresses. The range given can be of 
process-space addresses. 


If /PTE_ADDRESS is given, the range is expressed using the following syntax: 


m Displays the single page table entry at address m 

m:n Displays the page table entries from address m to address n 

m;n Displays n bytes of page table entries starting at address m 

If /PTE_ADDRESS is not given, then range is expressed using the following 
syntax: 

m Displays the single page table entry that corresponds to virtual address m 


m:n Displays the page table entries that correspond to the range of virtual 
addresses from m to n 


m;n Displays the page table entries that correspond to a range of n bytes 
starting at virtual address m 


Note that OpenVMS Alpha and 164 page protections are slightly different. For 
additional information, see Section 2.8. 


Qualifiers 


/FREE 

Causes the starting addresses and sizes of blocks of pages in the free PTE list 

to be displayed. The qualifiers /SOS1 (default), /S2, /GLOBAL, and /HEADER 
determine which free PTE list is to be displayed. A range cannot be specified, and 
no other qualifiers can be combined with /FREE. 


/GLOBAL 
Lists the global page table. When used with the /FREE qualifier, /GLOBAL 
indicates the free PTE list to be displayed. 


/HEADER=address 
When used with the /FREE qualifier, the /HEADER=address qualifier displays 
the free PTE list for the specified private page table. 
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IGPT 
Specifies the portion of page table space that maps the global page table as the 
address range. 


/INVALID_PFN [=option] 

The /INVALID_PFN qualifier, which is valid only on platforms that supply an I/O 
memory map, causes SDA to display only page table entries that map to PFNs 
that are in neither the system’s private memory, nor Galaxy-shared memory, nor 
are I/O access pages. 


See the /NONMEMORY_PFN qualifier definition for a description of the options. 


/L1 
Lists the Level 1 page table entries for the portion of memory specified. 


/L2 
Lists the Level 2 page table entries for the portion of memory specified. 


/L3 
Lists the Level 3 page table entries for the portion of memory specified. This 
qualifier is the default level. 


/NONMEMORY_PFN [=option] 
The /NONMEMORY_PFN qualifier causes SDA to display only page table entries 
that are in neither the system’s private memory nor Galaxy-shared memory. 


Both /INVALID_PFN and /NONMEMORY_PFN qualifiers allow two optional 
keywords, READONLY and WRITABLE. If neither keyword is given, all relevant 
pages are displayed. 


If READONLY is given, only pages marked for no write access are displayed. 

If WRITABLE is given, only pages that allow write access are displayed. For 
example, SHOW PAGE_TABLE=ALL/INVALID_PFN=WRITABLE would display 
all system pages whose protection allows write, but which map to PFNs that do 
not belong to this system. 


/PT 
Specifies page table space, as viewed from system context, as the address range. 


/PTE_ADDRESS 
Specifies that the range given is of PTE addresses instead of the virtual addresses 
mapped by the PTEs. 


/SECTION_INDEX=n 

Displays the page table for the range of pages in the global section or pageable 
part of a loaded image. For pageable portions of loaded images, one of the 
qualifiers /L1, /L2, or /L3 can also be specified. 


/SOS1 

Specifies SO and S1 space as the address range. When used with the /FREE 
qualifer, /SOS1 indicates the free PTE list to be displayed. This is the default 
portion of memory or free PTE list to be displayed. 


/S2 
Specifies S2 space as the address range. When used with the /FREE qualifier, /S2 
indicates the free PTE list to be displayed. 
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/SPTW 
Displays the contents of the system page table window. 


Option 


=ALL 

The SHOW PAGE = ALL command displays the page table entries for all shared 
(system) addresses, without regard to the section of memory being referenced. 

It is equivalent to specifying all of /SOS1, /S2, /SPTW, /PT, /GPT, and /GLOBAL. 
This option can be qualified by only one of the /L1, /L2, or /L8 qualifiers, or by 
/INVALID_PFN or /NONMEMORY_PFN. 


Description 


If the /FREE qualifier is not specified, this command displays page table entries 
for the specified range of addresses or section of memory. For each virtual 
address displayed by the SHOW PAGE_TABLE command, the first eight columns 
of the listing provide the associated page table entry and describe its location, 
characteristics, and contents. SDA obtains this information from the system page 
table or from the process page table if a process_space address is given. Table 4—7 
describes the information displayed by the SHOW PAGE_TABLE command. 


If the /FREE qualifier is specified, this command displays the free PTE list for 
the specified section of memory. 


The /L1, /L2, and /L3 qualifiers are ignored when used with the /FREE, 
/GLOBAL, and /SPTW qualifiers. 


Table 4-7 Virtual Page Information in the SHOW PAGE_TABLE Display 


Value Meaning 

MAPPED Virtual address that marks the base of the virtual page(s) 

ADDRESS mapped by the PTE. 

PTE ADDRESS Virtual address of the page table entry that maps the 
virtual page(s). 

PTE Contents of the page table entry, a quadword that describes 
a system virtual page. 

TYPE Type of virtual page. Table 4-8 shows the eight types and 
their meanings. 

READ (Alpha only.) A code, derived from bits in the PTE, that 


designates the processor access modes (kernel, executive, 
supervisor, or user) for which read access is granted. 


WRIT (Alpha only.) A code, derived from bits in the PTE, that 
designates the processor access modes (kernel, executive, 
supervisor, or user) for which write access is granted. 


(continued on next page) 
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Table 4-7 (Cont.) Virtual Page Information in the SHOW PAGE_TABLE Display 


Value 


Meaning 


MLOA 


AR/PL 


KESU 


MLO 


GH 


(Alpha only.) Letters that represent the setting of a bit 
or a combination of bits in the PTE. These bits indicate 
attributes of a page. Table 4—9 shows the codes and their 
meanings. 


(164 only.) The access rights and privilege level of the page. 
Consists of a number (0-7) and a letter (K, E, S, or U) that 
determines access to a page in each mode. 


(164 only.) The access allowed to the page in each mode. 
This is an interpretation of the AR/PL values in the 
previous column. For an explanation of the access codes, 
see Section 2.8, Page Protections and Access Rights. 


(164 only.) Letters that represent the setting of a bit or 
a combination of bits in the PTE. These bits indicate 
attributes of a page. Table 4—9 shows the codes and their 
meanings. 


Contents of granularity hint bits. 


Table 4-8 Types of Virtual Pages 


Type Meaning 

VALID Valid page (in main memory). 

TRANS Transitional page (on free or modified page list). 

DZERO Demand-allocated, zero-filled page. 

PGFIL Page within a paging file. 

STX Section table’s index page. 

GPTX Index page for a global page table. 

IOPAG Page in I/O address space. 

NXMEM Page not represented in physical memory. The page frame 


number (PFN) of this page is not mapped by any of the system’s 
memory controllers. This indicates an error condition. 


Table 4-9 Bits In the PTE 


Column Name 


Code Meaning 


>OOCOOrrs 


Page has been modified. 

Page is locked into a working set. 
Page is locked in physical memory. 
Owner is kernel mode. 

Owner is executive mode. 

Owner is supervisor mode. 

Owner is user mode. 


> adn A Ue eZ 


Address space match is set (Alpha only). 
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If the virtual page has been mapped to a physical page, the last five columns 
of the listing include information from the page frame number (PFN) database; 
otherwise, the section is left blank. Table 4-10 describes the physical page 
information displayed by the SHOW PAGE_TABLE command. 


Table 4-10 Physical Page Information in the SHOW PAGE_TABLE Display 


Category 


Meaning 


PGTYP 


LOC 


BAK 


REFCNT 
WSLX 


Type of physical page. Table 4-11 shows the types of physical 
pages. 

Location of the page within the system. Table 4-12 shows the 
possible locations with their meaning. 

Place to find information on this page when all links to this 
PTE are broken: either an index into a process section table or 
the number of a virtual block in the paging file. 

Number of references being made to this page. 

Working Set List Index. This shows as zero for resident and 
global pages, and is left blank for transition pages. 


Table 4-11 Types of Physical Pages 


Page Type 


Meaning 


PROCESS 
SYSTEM 
GLOBAL 
GBLWRT 
PPGTBL 
GPGTBL 
PHD! 
PPT(Ln)! 
SPT(Ln)? 
SHPT? 
PFNLST2 


SHM_REG? 
UNKNOWN 


Page is part of process space. 

Page is part of system space. 

Page is part of a global section. 

Page is part of a global, writable section. 
Page is part of a process page table. 

Page is part of a global page table. 

Page is part of a process PHD. 

Page is a process page table page at level n. 
Page is a system page table page at level n. 
Page is part of a shared page table. 


Page is in a Shared Memory Common Property Partition PFN 
database. 


Page is in a Shared Memory Region. 
Unknown. 


1These page types are variants of the PPGTBL page type. 


2These page types are variants of the SYSTEM page type. 


’These page types are variants of the GBLWRT page type. 
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Table 4-12 Locations of Physical Pages 


Location 


Meaning 


ACTIVE 
MFYLST 
FRELST 
BADLST 
RELPND 
RDERR 
PAGOUT 
PAGIN 
ZROLST 
UNKNWN 


Page is in a working set. 

Page is in the modified page list. 

Page is in the free page list. 

Page is in the bad page list. 

Release of the page is pending. 

Page has had an error during an attempted read operation. 
Page is being written into a paging file. 

Page is being brought into memory from a paging file. 
Page is in the zeroed-page list. 

Location of page is unknown. 


SDA indicates pages are inaccessible by displaying one of the following messages: 


1 null page: 


---- 974 null pages: 


VA FFFFFFFE.00064000 PTE 


VA FFFFFFFE.00064000 PTE 
-to- FFFFFFFE.007FDFFF 


FFFFFFFD.FF800190 


FFFFFFFD.FF800190 


-to- FFFFFFFD.FF801FF8 


In this case, the page table entries are not in use (page referenced is inaccessible). 


1 entry not in memory: VA 


784384 entries not in memory: VA 


FFFFFFFE.00800000 PTE 


FFFFFFFE.00800000 PTE 
-to- FFFFFFFF.7F7FDFFF -to- 


FFFFFFFD.FF802000 


FFFFFFFD.FF802000 
FFFFFFFD.FFDFDFF8 


In this case, the page table entries do not exist (PTE itself is inaccessible). 


1 free PTE: 


---- 1000 free PTEs: 


-to- FFFFFFFF.7FFCDFFF 


FFFFFFFF.7F800000 PTE 


FFFFFFFF.7F800000 PTE 
-to- 


FFFFFFFD.FFDFEOOO 


FFFFFFFD.FFDFE000 
FFFFFFFD.FFDFFF38 


In this case, the page table entries are in the list of free system pages. 


In each case, VA is the MAPPED ADDRESS of the skipped entry, and PTE is the 
PTE ADDRESS of the skipped entry. 


Examples 


1 


For an example of SHOW PAGE_TABLE output when the qualifier /FREE has 
not been given, see the SHOW PROCESS/PAGE_TABLES command. 


SDA> SHOW PAGE TABLE/FREE 


S0/S1 Space Free PTEs 


MAPPED ADDRESS 


FFFFFFFF.82A08000 
FFFFFFFF.82A16000 
FFFFFFFF .82A24000 
FFFFFFFF .82CF0000 
FFFFFFFF .82D00000 


PTE ADDRESS PTE COUNT 
FFFFFFFD.FFEQA820 OQ01FFE0.A8580000 00000003 
FFFFFFFD.FFEQA858  OQ01FFE0.A8900000 00000003 
FFFFFFFD.FFE0A890 0OQ01FFE0.B3C00000 00000003 
FFFFFFFD.FFEQB3C0 OQ01FFE0.B4010000 00000001 
FFFFFFFD.FFEQB400 QOQ01FFE0.B4680000 00000002 
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FFFFFFFF .82E48000 
FFFFFFFF .82E4E000 
FFFFFFFF .82E88000 
FFFFFFFF .8325E000 
FFFFFFFF .83326000 


This example shows the output when you invoke the SHOW PAGE_TABLE/FREE 


FFFFFFFD.FFE0B920 
FFFFFFFD.FFE0B938 
FFFFFFFD.FFEOBA20 
FFFFFFFD.FFE0C978 
FFFFFFFD.FFE0CC98 


command. 
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Q0001FFE0.B9390000 
Q0001FFEO.BA200000 
Q001FFEO.C9780000 
Q0001FFEO.CC980000 
00000000.00000000 


00000001 
00000002 
00000003 
00000003 
0000066D 
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SHOW PARAMETER 


Format 


Parameter 


Qualifiers 


Displays the name, location, and value of one or more SYSGEN parameters 
currently in use or at the time that the system dump was taken. 


SHOW PARAMETER [SYSGEN_parameter] 
[/ACP][/ALL][//CLUSTER][/DYNAMIC][/GALAXY] 
[/GEN][/JOB][/LGI][/MAJOR][/MULTIPROCESSING] 
[//OBSOLETE][/PQL][/RMS][/SCS][/SPECIAL] 
[/SYS][//STARTUP][/TT Y] 


SYSGEN_parameter 

Name of a parameter to be displayed. The name given may include wildcards. 
However, a truncated name is not recognized, unlike the equivalent SYSGEN and 
SYSMAN commands. 


/ACP 
Displays all Files-11 ACP parameters. 


/ALL 
Displays the values of all parameters except the special control parameters. 


/CLUSTER 
Displays all parameters specific to clusters. 


/DYNAMIC 
Displays all parameters that can be changed on a running system. 


IGALAXY 
Displays all parameters specific to Galaxy systems. 


/GEN 
Displays all general parameters. 


/JOB 
Displays all Job Controller parameters. 


/LGI 
Displays all LOGIN security control parameters. 


/MAJOR 
Displays the most important parameters. 


/MULTIPROCESSING 
Displays parameters specific to multiprocessing. 


/OBSOLETE 
Displays all obsolete system parameters. SDA displays obsolete parameters only 
if they are named explicitly (no wildcards) or if /OBSOLETE is given. 
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/PQL 
Displays the parameters for all default and minimum process quotas. 


/RMS 
Displays all parameters specific to OpenVMS Record Management Services 
(RMS). 


/scs 
Displays all parameters specific to OpenVMS Cluster System Communications 
Services. 


/SPECIAL 
Displays all special control parameters. 


/STARTUP 
Displays the name of the site-independent startup procedure. 


ISYS 
Displays all active system parameters. 


ITTY 
Displays all parameters for terminal drivers. 


Description 


The SHOW PARAMETER command displays the name, location, and value of one 
or more SYSGEN parameters at the time that the system dump is taken. You 
can specify either a parameter name, or one or more qualifiers, but not both a 
parameter and qualifiers. If you do not specify a parameter or qualifiers, then the 
last parameter displayed is displayed again. 


The qualifiers are the equivalent to those available for the SHOW [parameter] 
command in the SYSGEN utility and the PARAMETERS SHOW command in the 
SYSMAN utility. See the HP OpenVMS System Management Utilities Reference 
Manual: M-Z for more information about these two commands. You can combine 
qualifiers, and all appropriate SYSGEN parameters are displayed. 


Note 


To see the entire set of parameters, use the SDA command 
SHOW PARAMETER /ALL /SPECIAL /STARTUP/OBSOLETE. 
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1. SDA> SHOW PARAMETER *SCS* 


Parameter 
SCSBUFFCNT 
SCSCONNCNT 
SCSRESPCNT 
SCSMAXDG 
SCSMAXMSG 
SCSFLOWCUSH 
SCSSYSTEMID 
SCSSYSTEMIDH 
SCSNODE 
NISCS_CONV_BOOT 
NISCS_LOAD_PEAO 
NISCS_PORT_SERV 
SCSICLUSTER_P1 
SCSICLUSTER_P2 
SCSICLUSTER_P3 
SCSICLUSTER_P4 
NISCS_MAX_PKTSZ 
NISCS_LAN_OVRHD 


Variable 
ScCS$GW_BDTCNT 
SCS$GW_CDTCNT 
SCSS$GW_RDTCNT 
SCSS$GW_MAXDG 
SCSS$GW_MAXMSG 
SCS$GW_FLOWCUSH 
SCS$GB_SYSTEMID 
SCS$GB_SYSTEMIDH 
SCS$GB_NODENAME 
CLUS$GL_SGN_FLAGS 
CLUS$GL_SGN_FLAGS 
CLUSGL_NISCS_PORT_SERV 
SGNS$GB_SCSICLUSTER_P1 
SGNS$GB_SCSICLUSTER_P2 
SGNS$GB_SCSICLUSTER_P3 
SGNS$GB_SCSICLUSTER_P4 
CLUSGL_NISCS_MAX_PKTSZ 
CLUS$GL_NISCS_LAN_OVRHD 


80C159A0 
80C159A8 
80C159B0 
80C159B8 
80C159C0 
80C159C8 
80C159D0 
80C159D8 
80C159E0 
80C15E68 
80C15E68 
80C15E70 
80C15EF8 
80C15F00 
80C15F08 
80C15F10 
80C16070 
80C16078 


OOOOFE88 
00000000 
"SWPCTX 
0) 
0) 
00000000 


QOOOOS5DA 
00000012 


1498 
18 
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CLUSV_NISCS_CONV_BOOT (1) 
CLUSV_NISCS_LOAD_PEAO (0) 


VM-0060A-AI 


This example shows all parameters that have the string "SCS" in their name. For 
parameters defined as a single bit, the name and value of the bit offset within the 
location used for the parameter are also given. 


2. SDA> SHOW PARAMETER WS* 


Parameter 


(internal) 
WSINC 

(internal) 
WSDEC 

(internal) 


Variable 
SGN$GL_MAXWSCNT_PAGELETS 
SGN$GL_MAXWSCNT_PAGES 
SCH$GL_WSINC_PAGELETS 
SCH$GL_WSINC_PAGES 
SCH$GL_WSDEC_PAGELETS 
SCH$GL_WSDEC_PAGES 


Address 

80C15710 
80C15718 
80C157F8 
80C15800 
80C15808 
80C15810 


Value 
00006800 
00000680 
00000960 
00000096 
O0O0000FAO 
OQOOO000FA 


(decimal) 


Offset 


VM-0764A-Al 


This example shows all parameters whose names begin with the string "WS". For 
parameters that have both an external value (pagelets) and an internal value 


(pages), both are displayed. 


3. SDA> SHOW PARAMETER /MULTIPROCESSING /STARTUP 


SYSGEN parameters 


SMP_CPUS 
MULTIPROCESSING 
SMP_SANITY_CNT 
SMP_SPINWAIT 
SMP_LNGSPINWAIT 
I0_PREFER_CPUS 


Startup command 


Variable 
SGNS$GL_SMP_CPUS 
SGN$GB_MULTIPROCESSING 
SGNS$GL_SMP_SANITY_CNT 
SGNS$GL_SMP_SPINWAIT 
SGN$GL_SMP_LNGSPINWAIT 
SMP$GL AVAILABLE PORT_CPUS 


file = SYSS$SYSTEM:STARTUP.COM 


80C15688 
80C15698 
80C156A8 
80C156B8 
80C156C0 
80C16130 


FFFFFFFF 

03 
0000012Cc 
000186A0 
002DC6CO 
FFFFFFFF 


(decimal) 


300 
100000 
3000000 
-1 


VM-0765A-Al 


This example shows all the parameters specific to multiprocessing, plus the name 
of the site-independent startup command procedure. 
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SHOW PFN_DATA 


Displays information that is contained in the page lists and PFN database. 


Format 
SHOW PFN_DATA  {{/qualifier] | pfn [{:end-pfn | ;length}]} 
or 
SHOW PFN_DATA/MAP 


Parameters 


pfn 
Page frame number (PFN) of the physical page for which information is to be 
displayed. 


end-pfn 

Last PFN to be displayed. When you specify the end-pfn parameter, a range of 
PFNs is displayed. This range starts at the PFN specified by the pfn parameter 
and ends with the PFN specified by the end-pfn parameter. 


length 

Length of the PFN list to be displayed. When you specify the length parameter, 

a range of PFNs is displayed. This range starts at the PFN specified by the pfn 

parameter and contains the number of entries specified by the length parameter. 


Qualifiers 


/ADDRESS=<PFN-entry-address> 

Displays the PFN database entry at the address specified. The address specified 
is rounded to the nearest entry address, so if you have an address that points to 
one of the fields of the entry, the correct database entry will still be found. 


/ALL 
Displays the following lists: 


Free page list 

Zeroed free page list 

Modified page list 

Bad page list 

Untested page list 

Private page lists, if any 

Per-color or per-RAD free and zeroed free page lists 
Entire database in order by page frame number 


This is the default behavior of the SHOW PFN_DATA command. SDA precedes 
each list with a count of the pages it contains and its low and high limits. 


/BAD 
Displays the bad page list. SDA precedes the list with a count of the pages it 
contains, its low limit, and its high limit. 
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/COLOR [={n1 ALL}] 
Displays data on page coloring. Table 4-13 shows the command options available 
with this qualifier. 


Table 4-13 Command Options with the /COLOR and /RAD Qualifiers 
Options Meaning 


/COLOR! with no value Displays a summary of the lengths of the color! 
page lists for both free pages and zeroed pages. 


/COLOR=n where n is acolor Displays the data in the PFN lists (for the 
number specified color) for both free and zeroed pages. 


/COLOR=ALL Displays the data in the PFN lists (for all colors), 
for both free and zeroed free pages. 


/COLOR=n or /COLOR=ALL Displays only the data in the PFN list (for 

with /FREE or /ZERO the specified color or all colors), for either 
free or zeroed free pages as appropriate. The 
qualifiers /BAD and /MODIFIED are ignored 
with /COLOR=n and /COLOR=ALL. 


/COLOR without an option Displays the color summary in addition to the 
specified together with one or display of the requested list. 

more of /FREE, /ZERO, /BAD, 

or /MODIFIED 


1Wherever COLOR is used in this table, RAD is equally applicable, both in the qualifier name and the 
meaning. 


For more information on page coloring, see HP OpenVMS System Management 
Utilities Reference Manual: M-Z. 


/FREE 
Displays the free page list. SDA precedes the list with a count of the pages it 
contains, its low limit, and its high limit. 


/MAP 

Displays the contents of the PFN memory map. On platforms that support it, the 
I/O space map is also displayed. You cannot combine the /MAP qualifier with any 
parameters or other qualifiers. 


/MODIFIED 
Displays the modified page list. SDA precedes the list with a count of the pages 
it contains, its low limit, and its high limit. 


/PRIVATE [=address] 

Displays private PFN lists. If no address is given, all private PFN lists are 
displayed; if an address is given, only the PFN list whose head is at the given 
address is displayed. 


/RAD [={n 1 ALL}] 

Displays data on the disposition of pages among the Resource Affinity Domains 
(RADs) on applicable systems. See Table 4-13 for the command options available 
with this qualifier. 
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Description 


DATA 


/SYSTEM 
Displays the entire PFN database in order by page frame number, starting at 
PFN 0000. 


/UNTESTED 
Displays the state of the untested PFN list that was set up for deferred memory 
testing. 


[ZERO 
Displays the contents of the zeroed free page list. 


For each page frame number it displays, the SHOW PFN_DATA command lists 
information used in translating physical page addresses to virtual page addresses. 


The display contains two or three lines: Table 4-14 shows the fields in line one, 
Table 4-15 shows the fields in line two, and Table 4—16 shows the fields in line 
three, displayed only if relevant (page table page or non-zero flags). 


Table 4-14 PFN Data—Fields in Line One 


Item Contents 

PFN Page frame number. 

DB ADDRESS Address of PFN structure for this page. 

PT PFN PFN of the page table page that maps this page. 
BAK Place to find information on this page when all links 


to this PTE are broken: either an index into a process 
section table or the number of a virtual block in the 
paging file. 

FLINK Forward link within PFN database that points to the next 
physical page (if the page is on one of the lists: FREE, 
MODIFIED, BAD, or ZEROED); this longword also acts 
as the count of the number of processes that are sharing 
this global section. 


BLINK Backward link within PFN database (if the page is on one 
of the lists: FREE, MODIFIED, BAD, or ZEROED); also 
acts as an index into the working set list. 


SWP/BO Either a swap file page number or a buffer object reference 
count, depending on a flag set in the page state field. 
LOC Location of the page within the system. Table 4-12 shows 


the possible locations with their meaning. 
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Table 4-15 PFN Data—Fields in Line Two 


Item 


Contents 


(Blank) 
PTE ADDRESS 


PTE Type 


REFCNT 
PAGETYP 


First field of line two is left blank. 


Virtual address of the page table entry that 
describes the virtual page mapped into this 
physical page. If no virtual page is mapped 
into this physical page then "<no backpointer>" 
is displayed, and the next three fields are left 
blank. 


If a virtual page is mapped into this physical 
page, a description of the type of PTE is provided 
across the next three fields: one of "System- 
space PTE", "Global PTE (section index nnnn)", 
"Process PTE (process index nnnn)". If no virtual 
page is mapped into this physical page, these 
fields are left blank. 

Number of references being made to this page. 


Type of physical page. See Table 4—11 for the 
types of physical pages and their meanings. 


Table 4-16 PFN Data—Fields in Line Three 


Item 


COUNTS 


FLAGS 


Contents 


If the page is a page table page, then the 
contents of the PRN$W_PT_VAL_CNT, PFN$W_ 
PT_LCK_CNT, and PFN$W_PT_WIN_CNT fields 
are displayed. The format is as follows: 


VALCNT = nnnn LCKCNT = nnnn WINCNT = nnnn 


The flags in text form that are set in page state. 
Table 4-17 shows the possible flags and their 
meaning. 
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Table 4-17 Flags Set in Page State 


Flag Meaning 

BUFOBJ Set if any buffer objects reference this page 

COLLISION Indicates an empty collision queue when page read is 
complete 

BADPAG Indicates a bad page 

RPTEVT Indicates a report event on I/O completion 

DELCON Indicates a delete PFN when REFCNT=0 

MODIFY Indicates a dirty page (modified) 

UNAVAILABLE Indicates PFN is unavailable; most likely a console page 

SWPPAG_VALID Indicated swap file page number is valid 

TOP_LEVEL_PT Level one (1) page table 

SLOT Page is part of process’s balance set 

SHARED Shared memory page 

ZEROED Shared memory page that has been zeroed 


Examples 


1. SDA> SHOW PFN_DATA/MAP 
System Memory Map 


00000000 OO0000FA 0009 Console Base 
000000FA 00003306 000A OpenVMS Base 
00003C00 000003FF 000A OpenVMS Base 
00003FFF 00000001 0009 Console Base 
00003400 00000800 0010 Galaxy Shared 


This example shows the output when you invoke the SHOW PFN/MAP command. 
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SDA> show pfn 598 


PFN data base for 


00000000.00000598 
00000000.00000599 


00000000.0000059A 


00000000.0000059B 


00000000.0000059C 


00000000.0000059D 


00000000.0000059E 


00000000.0000059F 


SDA> SHOW PFN 598:59f 


259£ 


PFN range 


DB ADDRESS 

PTE ADDRESS 
FFFFF802.06C16600 
FFFFF801.FFD072A0 


FFFFF802.06C16640 
<no backpointer> 


FFFFF802. 
OOOOO7FF. 
FLAGS = 


06C16680 
FF700000 
Modify 


FFFFF802. 
FFFFF802. 


06C166CO 
OF641680 


FFFFF802. 
OOOOO7FE. 


06C16700 
00001C30 


FFFFF802. 
OOOOO7FF. 
VALCNT = 


06C16740 
FFFFFFF8 
0002 


FFFFF802. 
FFFFF801. 


06C16780 
FFD07420 


FFFFF802. 
FFFFF801. 


06C167CO 
FFD07428 


00000000.000001D7 FFFFFFFF.84D6F700 
System-space PTE 


00000000.00000000 00000000.0001DBD9 


00000000.00000565 FFO00000.00000000 
Process PTE (process index 001A) 


00000000.0000493A OO00000FD.00010000 
Global PTE (section index 0OFD) 


00000000.000005E3 FFO00000.00000000 
Process PTE (process index 000F) 


00000000.0000059D 00000000.8705A000 
Process PTE (process index 0005) 
LCKCNT = FFFF WINCNT = FFFF 


00000000.000001D7 FFFFFFFF.84D6F700 
System-space PTE 


00000000.000001D7 FFFFFFFF.84D6F700 
System-space PTE 


00000000. 


00000000. 


00000000. 


00000000. 


00000000. 


00000000. 


FLAGS = 


00000000. 


00000000. 


00000000 


0001DBD9 


00000000 


00000003 


00000000 


00000002 
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00000000.00000000 
00000000.000081B6 


00000000.000000D4 


00000000.00000000 


00000000.00000136 


00000000.00000001 


Modify, Top_Level_PT 


00000000 


00000000 


00000000.00000000 


00000000.00000000 


SWP/BO LOC 
REFCNT PAGETYP 
---- ACTIVE 
0001 SYSTEM 
----  FRELST 
0000 SYSTEM 
---- ACTIVE 
0001 PROCESS 
---- ACTIVE 
0001 GLOBAL 
---- ACTIVE 
0001 PROCESS 
---- ACTIVE 
0001 PPT(L1) 
---- ACTIVE 
0001 SYSTEM 
---- ACTIVE 
0001 SYSTEM 
VM-1166A-Al 


This example shows the output from SHOW PEN for a range of pages. 
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SHOW POOL 


Format 


Parameter 


Qualifiers 


Displays the contents of the nonpaged dynamic storage pool, the bus-addressable 
pool, and the paged dynamic storage pool. You can display part or all of each 
pool. If you do not specify a range or qualifiers, the default is SHOW POOL/ALL. 
Optionally, you can display the pool history ring buffer and pool statistics. 


SHOW POOL {rangel/ALL (d)!/BAP |/NONPAGED1/PAGED} 
[/BRIEF |/CHECK|/FREE|/HEADER 
|/MAXIMUM_BYTES [=n]|/SUMMARY |/TYPE=packet-type 
|/SUBTYPE=packet-type | /UNUSED] 
| [|/RING_BUFFER] 
|[/STATISTICS [= ALL] [{/NONPAGED |/BAP |/PAGED}]] 


range 
Range of virtual addresses in pool that SDA is to examine. You can express a 
range using the following syntax: 


m:n Range of virtual addresses in pool from m to n 
m;n Range of virtual addresses in pool starting at m and continuing for n bytes 


/ALL 

Displays the entire contents of the dynamic storage pool, except for those portions 
that are free (available). This is the default behavior of the SHOW POOL 
command. 


/BAP 
Displays the contents of the bus-addressable dynamic storage pool currently in 
use. 


/BRIEF 
Displays only general information about the dynamic storage pool and its 
addresses. 


ICHECK 
Checks all free packets for POOLCHECK-style corruption, in exactly the same 
way that the system does when generating a POOLCHECK crash dump. 


/FREE 

Displays the entire contents, both allocated and free, of the specified region or 
regions of pool. Use the /FREE qualifier with a range to show all of the used and 
free pool in the given range. 


/HEADER 
Displays only the first 16 bytes of each data packet found within the specified 
region or regions of pool. 


/MAXIMUM_BYTES [=n] 
Displays only the first n bytes of a pool packet; if you specify /MAXIMUM_BYTES 
without a value, the default is 64 bytes. 
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/NONPAGED 
Displays the contents of the nonpaged dynamic storage pool currently in use. 


/PAGED 
Displays the contents of the paged dynamic storage pool currently in use. 


/RING_BUFFER 

Displays the contents of the nonpaged pool history ring buffer if pool checking 
has been enabled. Entries are displayed in reverse chronological order, that is, 
most to least recent. 


/STATISTICS [= ALL] 

Displays usage statistics about each lookaside list and the variable free list. For 
each lookaside list, its queue header address, packet size, the number of packets, 
attempts, fails, and deallocations are displayed. (If pool checking is disabled, the 
attempts, fails, and deallocations are not displayed.) For the variable free list, 
its queue header address, the number of packets and the size of the smallest and 
largest packets are displayed. You can further qualify /STATISTICS by using 
either /NONPAGED, /BAP, or /PAGED to display statistics for a specified pool 
area. (Paged pool has no lookaside lists; therefore, only variable free list statistics 
are displayed.) 


If you specify /STATISTICS without the ALL keyword, only active lookaside lists 
are displayed. Use /STATISTICS = ALL to display all lookaside lists. 


/SUBTYPE=packet-type 

Displays the packets within the specified region or regions of pool that are of 
the indicated packet-type. For information on packet-type, see packet-type in the 
Description section. 


/SUMMARY 
Displays only an allocation summary for each specified region of pool. 


/TYPE=packet-type 

Displays the packets within the specified region or regions of pool that are of 
the indicated packet-type. For information on packet-type, see packet-type in the 
Description section. 


/UNUSED 
Displays only variable free packets and lookaside list packets, not used packets. 


The SHOW POOL command displays information about the contents of any 
specified region of dynamic storage pool. There are several distinct display 
formats, as follows: 


e Pool layout display. This display includes the addresses of the pool structures 
and lookaside lists, and the ranges of memory used for pool. 


e Full pool packet display. This display has a section for each packet, consisting 
of a summary line (the packet type, its start address and size, and, on 
systems that have multiple Resource Affinity Domains (RADs), the RAD 
number), followed by a dump of the contents of the packet in hexadecimal and 
ASCII. 
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e Header pool packet display. This display has a single line for each packet. 
This line contains the packet type, its start address and size, and, on systems 
that have multiple RADs, the RAD number, followed by the first 16 bytes of 
the packet, in hexadecimal and ASCII. 


e Pool summary display. This display consists of a single line for each packet 
type, and includes the type, the number of occurrences and the total size, and 
the percentage of used pool consumed by this packet type. 


e Pool statistics display. This display consists of statistics for variable free pool 
and for each lookaside list. For variable free pool, it includes the number of 
packets, the total bytes available, and the sizes of the smallest and largest 
packets. In addition, if pool checking is enabled, the total bytes allocated from 
the variable list and the number of times pool has been expanded are also 
displayed. 


For lookaside lists, the display includes the listhead address and size, the 
number of packets (both the maintained count and the actual count), the 
operation sequence number for the list, the allocation attempts and failures, 
and the number of deallocations. 


On systems with multiple RADs, statistics for on-RAD deallocations are 
included in the display for the first RAD. 


e Ring buffer display. This display is only available when pool checking is 
enabled. It consists of one line for each packet in the ring buffer and includes 
the address and size of the pool packet being allocated or deallocated, its type, 
the PC of the caller and the pool routine called, the CPU and IPL of the call, 
and the system time. 


The qualifiers used on the SHOW POOL command determine which displays are 
generated. The default is the pool layout display, followed by the full pool packet 
display, followed by the pool summary display, these being generated in turn for 
Nonpaged Pool, Bus-Addressable Pool (if it exists in the system or dump being 
analyzed), and then Paged Pool. 


If you specify a range, type, or subtype, then the pool layout display is not 
generated, and the pool summary display is a summary only for the range, type, 
or subtype, and not for the entire pool. 


Not all displays are relevant for all pool types. For example, Paged Pool has no 
lookaside lists, so the Paged Pool statistics display consists only of variable free 
pool information. And because there is a single ring buffer for all pools, only one 
ring buffer display is generated even if all pools are being displayed. 


Packet-type 

Each packet of pool has a type field (a byte containing a value in the range of 
0-255). Many of these type values have names associated that are defined in 
$DYNDEF in SYS$LIBRARY:LIB.MLB. The packet-type specified in the /TYPE 
qualifier of the SHOW POOL command can either be the value of the pool type or 
its associated name. 


Some pool packet types have an additional subtype field (also a byte containing 
a value in the range of 0-255), many of which also have associated names. The 
packet-type specified in the /SUBTYPE qualifier of the SHOW POOL command 
can either be the value of the pool type or its associated name. However, if given 
as a value, a /TYPE qualifier (giving a value or name) must also be specified. 
Note also that /TYPE and /SUBTYPE are interchangeable if packet-type is given 
by name. Table 4-18 shows several examples. 
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Table 4-18 /TYPE and /SUBTYPE Qualifier Examples 
/TYPE and /SUBTYPE Qualifiers Meaning 
/TYPE = CI All CI packets regardless of subtype 
/TYPE = CI_MSG All CI packets with subtype CILMSG 


/TYPE = MISC/SUBTYPE = 120 All MISC packets with subtype 120 


/TYPE = 0 or /TYPE = UNKNOWN All packets with an unknown 
TYPE/SUBTYPE combination 
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Examples 


1. SDA> SHOW POOL 


Non-Paged Dynamic Storage Pool 


NPOOL address: 

Pool map address: 

Number of lookaside lists: 
Granularity size: 

Ring buffer address: 

Most recent ring buffer entry: 


LSTHDS(s) 


LSTHDS 
RAD address 


Variable 
listhead 


FFFFFFFF.8100883C 


00 FFFFFFFF.81008830 

01 FFFFFFFF.7FFFE000 FFFFFFFF.7FFFE00C 

02 FFFFFFFF.7FFFC000 FFFFFFFF.7FFFC00C 

03 FFFFFFFF.7FFFA000 FFFFFFFF.7FFFA00C 
Segment(s) 


Start End Length RAD 
81548000 8172B9FF 001E3A00 00 
81735A00 8173D53F 00007B40 00 
81747540 8174BDBF 00004880 00 
81755DC0 81AFDFFF 003A8240 00 
81AFE000 81C43FFF 00146000 01 
81¢44000 81D89FFF 00146000 02 
81D8A000 81ECFFFF 00146000 03 
81ED0000 81F1FFFF 00050000 02 


Per-RAD Totals 


RAD Length 
00 00598000 
o1 00146000 
02 00196000 
03 00146000 


Non-Paged total: 009BA000 


Dump of packets allocated from Non-Paged Pool 


Packet: MP_CPU 


00000000 00000000 0000003E 00000001 00000002 026A09CO ACD1A180 81C52F40 
81548038 81548038 81548030 81548030 81548028 81548028 00000000 00000001 
81548058 81548058 81548050 81548050 81548048 81548048 81548040 81548040 


Packet: Unknown 


FFFFFFFF AD332000 00500000 00008020 FFFFFFFF 81548B00 FFFFFFFF 81548A80 


Packet: DDB 


AD410000 81564480 81548BCO 000F4240 00000000 63060300 008B798F 962DA431 


4-166 SDA Commands 


81009088 
81562900 
128 

64 
81552200 
815553A0 


Lookaside 
listheads 
FFFFFFFF.81008868 
FFFFFFFF.7FFFE038 
FFFFFFFF.7FFFC038 
FFFFFFFF.7FFFA038 


Start address: 


Start address: 


Start address: 


81548000 Length: 000009C0 
@/R. NTR. Giee sees ds Ses anea dastes 
alate Sedna (2Po(-Ts0.T50.9.8.T.8.T. 
@.T.@.T.H.T.H.T.P.T.P.T.X.T.X.T. 
815489C0 Length: 00000180 

SD ret Pactra MD es ibeai, irae Piso BS sence 
81548B40 Length: 00000300 
1H-..y..... c....@B..A.T..DV...A— 


RAD: 00 
81548000 


81548020 
81548040 


RAD: 00 


815489C0 


RAD: 00 


81548B40 


Continued 
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Summary of Non-Paged Pool contents 


Packet type/subtype Packet count Packet bytes Percent 
Unknown 00000154 00145BC0 (50.7%) 
ADP 00000009 00000A00 (0.1%) 
ACB 0000008D 00002500 (0.4%) 
AQB 00000002 00001080 (0.2%) 
LOADCODE 0000003D 00004C40 (0.7%) 

LDRIMG 0000003D 00004c40 (0.7%) 
INIT 00000008 00003B80 (0.6%) 
PCBVEC 00000001 00001BCO (0.3%) 
PHVEC 00000001 00000700 (0.1%) 
MPWMAP 00000005 00001840 (0.2%) 
PRCMAP 00000001 00000080 (0.0%) 


Total space used: 002825C0 (2631104.) bytes out of 009BA000 (10199040.) bytes 
in 0000184C (6220.) packets 


Total space utilization: 25.8% 


VM-0768A-AI 
This example shows the Nonpaged Pool portion of the default SHOW POOL 
display. 
2. SDA> SHOW POOL/TYPE=IPC/HEADER 8156E140:815912C0 


Non-Paged Dynamic Storage Pool 


Packet type/subtype Start Length RAD Header contents 
IPC_TDB 8156E140 00000040 00 81591180 057B0040 00000040 81591180 ..Y.@...@.{...¥. 
IPC_LIST 815838C0 00009840 00  004C0200 087839840 0057A740 8158D100 .NX.@SW.@.{...L 
IPC_LIST 8158D100 00001840 00 00040400 087B1840 00570F00 8158E940 @éX...W.@.{... 
IPC_LIST 8158E940 00002840 00 00140200 087B2840 0056F6C0 81591180 ..Y.AOV.@({..... 
IPC_TPCB 81591180 00000080 00 00000000 067B0080 0056CE80 81591200 ..Y..IV...{..... 
IPC 81591200 000000C0 00 00000000 007B00C0 0056CE00 815912cO A.Y..iv.A.{ 


Summary of Non-Paged Pool contents 


Packet type/subtype Packet count Packet bytes Percent 

IPC 00000006 0000DA40 (100.03) 
IPC 00000001 000000C0 (0.3%) 
IPC_TDB 00000001 00000040 (0.13) 
IPC_TPCB 00000001 00000080 (0.23) 
IPC_LIST 00000003 0000D8CO (99.3%) 


Total space used: 0000DA40 (55872.) bytes out of 00023180 (143744.) bytes 
in 00000006 (6.) packets 


Total space utilization: 38.9% 


This example shows how you can specify a pool packet type and a range of 
addresses. 


SDA Commands 4-167 


SDA Commands 
SHOW POOL 


3. SDA> SHOW POOL/STATISTICS 
Non-Paged Pool statistics for RAD 00 


On-RAD deallocations (all RADs): 1221036 
Total deallocations (all RADs): 1347991 
Percentage of on-RAD deallocations: 90.6% 
Variable list statistics 
Number of packets on variable list: 7 
Total bytes on variable list: 3613376 
Smallest packet on variable list: 256 
Largest packet on variable list: 3598016 
Bytes allocated from variable list: 2140480 
Times pool expanded: 0 
Lookaside list statistics 
List Packets Packets Operation Allocation Allocation 
Listhead address size (approx) (actual) sequence # attempts failures 
FFFFFFFF.81008870 64 5 5 10057 10549 492 
FFFFFFFF.81008878 128 21 21 366 4881 4515 
FFFFFFFF.81008880 192 33 33 27376 27542 166 
FFFFFFFF.81008888 256 4 4 8367 8476 118 


This example shows the Nonpaged Pool portion of the SHOW 


POOL/STATISTICS 


4. SDA> SHOW POOL/RING_BUFFER 


Pool History Ring-Buffer 


display. 


Deallocs 


Packet Size Type/Subtype 
FFFFFFFF.81C65F40 320 SECURITY_PSB 80283A9C 
FFFFFFFF.81C44E00 192 SECURITY_PXB_ARRAY 80283A30 
FFFFFFFF.81C45A40 64 ACB 8014A09C 
FFFFFFFF.81C44E00 140 SECURITY_PXB_ARRAY 80283B8C 
FFFFFFFF.81C65F40 320 SECURITY_PSB 80283B70 
FFFFFFFF.81C45A40 64 ACB 801281F8 
FFFFFFFF.81C52380 576 IRP 8014A09C 
FFFFFFFF.81C65F40 320 SECURITY_PSB 80283A9C 
FFFFFFFF.81C44E00 192 SECURITY_PXB_ARRAY 80283A30 

81C47400 256 BUFIO 800F6270 


FFFFFFFF. 


NSA_STD$FREE_PSB_C+0024C 
NSA_STD$FREE_PSB_C+001E0 
SCHSINIT_C+00F18 
NSA$GET_PSB_C+0005C 
NSAS$GET_PSB_C+00040 

PROCESS MANAGEMENT MON+001F 
SCH$INIT_C+00F18 
NSA_STD$FREE_PSB_C+0024C 
NSA_STD$FREE_PSB_C+001E0 
IOC_STD$WAKACP_C+00650 


DEALLO_POOL_NPP 
DEALLO_POOL_NPP 
DEALLO_POOL_NPP_SIZ 
ALLO_POOL_NPP 
ALLO_POOL_NPP 
ALLO_POOL_NPP 
DEALLO_POOL_NPP_SIZ 
DEALLO_POOL_NPP 
DEALLO_POOL_NPP 
DEALLO_POOL_NPP_SIZ 


OO9F1E47. 
OO9F1E47. 
OO9F1E47. 
OO9F1E47. 
OO9F1E47. 
OO9F1E47. 
OO9F1E47. 
OO9F1E47. 
OO9F1E47. 
OO9F1E47. 


549449F0 
549449F0 
549449F0 
549449F0 
549449F0 
549449F0 
549449F0 
549449F0 
549449F0 
549449F0 


VM-0772A-Al 


This example shows the output of the SHOW POOL/RING_BUFFER display. 
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SHOW PORTS 


Format 


Parameters 


Qualifiers 


Description 


Displays those portions of the port descriptor table (PDT) that are port 
independent. 


SHOW PORTS _ [/qualifier[,...]] 


None. 


/ADDRESS=pat-address 

Displays the specified port descriptor table (PDT). You can find the pdt- 
address for any active connection on the system in the PDT summary page 
display of the SHOW PORTS command. This command also defines the 
symbol PE_PDT. The connection descriptor table (CDT) addresses are also 
stored in many individual data structures related to System Communications 
Services (SCS) connections, for instance, in the path block displays of the 
SHOW CLUSTER/SCS command. 


/BUS=bus-address 
Displays bus (LAN device) structure data. 


/CHANNEL=channel-address 
Displays channel (CH) data. 


/DEVICE 
Displays the network path description for a channel. 


/MESSAGE 
Displays the message data associated with a virtual circuit (VC). 


/NODE=node 

Shows only the virtual circuit block associated with the specific node. When 
you use the /NODE qualifier, you must also specify the address of the PDT 
using the /ADDRESS qualifier. 


VC=ve-address 
Displays the virtual circuit data. 


The SHOW PORTS command provides port-independent information from the 
port descriptor table (PDT) for those CI ports with full System Communications 
Services (SCS) connections. This information is used by all SCS port drivers. 
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The SHOW PORTS command also defines symbols for PEDRIVER based on 
the cluster configuration. These symbols include the following information: 


e Virtual circuit (VC) control blocks for each of the remote systems 
e Bus data structure for each of the local LAN adapters 


e Some of the data structures used by both PEDRIVER and the LAN 
drivers 


The following symbols are defined automatically: 


e VC_nodename—Example: VC_NODE1, address of the local node’s virtual 
circuit to node NODE1. 


e CH_nodename—The preferred channel for the virtual circuit. For 
example, CH_NODE1, address of the local node’s preferred channel to 
node NODE1. 


e BUS_busname—Example: BUS_ETA, address of the local node’s bus 
structure associated with LAN adapter ETAO. 


e PE_PDT—Address of PEDRIVER’s port descriptor table. 


e MGMT_VCRP_busname—Example: MGMT_VCRP_ETA, address of the 
management VCRP for bus ETA. 


e HELLO_VCRP_busname—Example: HELLO_VCRP_ETA, address of the 
HELLO message VCRP for bus ETA. 


e VCIB_busname—Example: VCIB_ETA, address of the VCIB for bus ETA. 


e UCB_LAVC_busname—Example: UCB_LAVC_ETA, address of the LAN 
device’s UCB used for the local-area OpenVMS Cluster protocol. 


e UCBO_LAVC_busname—Example: UCBO_LAVC_ETA, address of the 
LAN device’s template UCB. 


e LDC_LAVC_busname—Example: LDC_LAVC_ETA, address of the LDC 
structure associated with LAN device ETA. 


e LSB_LAVC_busname—Example: LSB_LAVC_ETA, address of the LSB 
structure associated with LAN device ETA. 


These symbols equate to system addresses for the corresponding data 
structures. You can use these symbols, or an address, in SHOW PORTS 
qualifers that require an address, as in the following: 


SDA >SHOW PORTS/BUS=BUS_ETA 


The SHOW PORTS command produces several displays. The initial display, 
the PDT summary page, lists the PDT address, port type, device name, and 
driver name for each PDT. Subsequent displays provide information taken 
from each PDT listed on the summary page. 


You can use the /ADDRESS qualifier to the SHOW PORTS command to 
produce more detailed information about a specific port. The first display 

of the SHOW PORTS/ADDRESS command duplicates the last display of 

the SHOW PORTS command, listing information stored in the port’s PDT. 
Subsequent displays list information about the port blocks and virtual circuits 
associated with the port. 
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SDA > SHOW PORTS 


OpenVMS Cluster data structures 


80E2A180 
80EC3C70 


Type: 09 pn 
Characteristics: 


Msg Header Size 
Max Xfer Bent 
Poller Sweep 
Fork Block W.Q. 
UCB Address 

ADP Address 

Max VC timeout 
SCS Version 


Type: 03 pe 
Characteristics: 


Msg Header Size 
Max Xfer Bent 
Poller Sweep 
Fork Block W.Q. 
UCB Address 

ADP Address 

Max VC timeout 
SCS Version 


--- PDT Summary Page --- 


Type 


pn 
pe 


0000 


104 
00100000 
21 
80E2A270 
80E23380 
80E1BF00 
16 

2 


Device 


Flags 

Counter CDRP 
Load Vector 
Load Class 
Connection W.Q. 
Yellow Q. 

Red Q. 

Disabled Q. 
Port Map 
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Driver Name 


SYSSPNDRIVER 
SYSSPEDRIVER 


--- Port Descriptor Table (PDT) 80E2A180 --- 


0000 
00000000 
80E2DFCC 

60 
80E4BF94 
80E2A2E0 
80E2A2E8 
80FABB74 
00000001 


Message Sends 
Message Recvs 
Mess Sends NoFP 
Mess Recvs NoFP 
Datagram Sends 
Datagram Recvs 
Portlock 

Res Bundle Size 


--- Port Descriptor Table (PDT) 80EC3C70 --- 


0000 


32 
FFFFFFFF 
30 
80EC3D60 
80EC33C0 
00000000 
16 

2 


Flags 

Counter CDRP 
Load Vector 
Load Class 
Connection W.Q. 
Yellow Q. 

Red Q. 

Disabled Q. 
Port Map 


0000 
00000000 
80EDBF8C 

10 
80EFF5D4 
80EC3DD0 
80EC3DD8 
812E72B4 
00000000 


Message Sends 
Message Recvs 
Mess Sends NoFP 
Mess Recvs NoFP 
Datagram Sends 
Datagram Recvs 
Portlock 

Res Bundle Size 


3648575 
4026887 
3020422 
3398732 
0 

0 
80E1ED80 
208 


863497 
886284 
863497 
886284 

0 

0 
00000000 
0 


This example illustrates the default output of the SHOW PORTS command. 
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SDA > SHOW PORTS/ADDRESS=80EC3C70 


OpenVMS Cluster data structures 


Type: 03 pe 


Characteristics: 


Msg Header Size 
Max Xfer Bent 
Poller Sweep 
Fork Block W.Q. 
UCB Address 

ADP Address 

Max VC timeout 
SCS Version 


Status: 0001 authorize 

VC Count: 20 

Secs Since Last Zeroed: 77020 

SBUF Size 824 LBUF Size 

SBUF Count 28 LBUF Count 

SBUF Max 768 LBUF Max 

SBUF Quo 28 LBUF Quo 

SBUF Miss 1871 LBUF Miss 

SBUF Allocs 1676801 LBUF Allocs 
SBUFs In Use 2 LBUFs In Use 
Peak SBUF In Use 101 Peak LBUF In Use 
SBUF Queue Empty 0 LBUF Queue Empty 
TR SBUF Queue Empty 0 Ticks/Second 

No SBUF for ACK 0 Listen Timeout 


--- Port Descriptor Table (PDT) 80EC3C70 --- 


0000 
32 Flags 
FFFFFFFF Counter CDRP 
30 Load Vector 
80EC3D60 Load Class 
80EC33C0 Connection W.Q. 
00000000 Yellow Q. 
16 Red Q. 
2 Disabled Q. 
Port Map 
Port Map 


--- Port Block 80EC4540 --- 


0000 
00000000 
80EDBF8C 

10 
80EFF5D4 
80EC3DD0 
80EC3DD8 
812E72B4 
00000000 
00000000 


5042 
1 
384 
il 
3408 
28596 
0 

10 

0 

10 

8 


Message Sends 
Message Recvs 
Mess Sends NoFP 
Mess Recvs NoFP 
Datagram Sends 
Datagram Recvs 
Portlock 

Res Bundle Size 


Fork Count 
Refork Count 
Last Refork 
SCS Messages 
VC Queue Cnt 
TQE Received 
Timer Done 
RWAITQ Count 
LDL Buf/Msg 
ACK Delay 
Hello Interval 


Time of Last 


864796 
887086 
864796 
887086 

0 

0 
00000000 
0 


1943885 
0 
00000000 
1154378 
361349 
770201 
770201 
30288 
32868 
1000000 
30 


Error 


Last Event Time 


8-FEB-2001 16: 
8-FEB-2001 16: 


01:57.58 
01:58.41 


Bus Addr Bus LAN Address Error Count Last Error 
80EC4C00 LCL 00-00-00-00-00-00 0 
80EC5400 EXA 08-00-2B-17-CF-92 0 
80EC5F40 FXA 08-00-2B-29-E1-40 0 
--- Virtual Circuit (VC) Summary --- 

vc Addr Node scS ID Lcl ID Status Summary 
80E566CO ARUSHA 19617 223/DF open,path 
80E98840 ETOSHA 19699 222/DE open,path 

VMS 19578 221/DD open,path 


80E98A80 


8-FEB-2001 16: 


01:58.11 


This example illustrates the output produced by the SHOW PORTS command 
for the PDT at address 80EC3C70. 
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SHOW PROCESS 


Format 


Displays the software and hardware context of any process in the system. If 
the process is suspended (ANALYZE/SYSTEM), then some displays may be 
incomplete or unavailable. If the process was outswapped at the time of the 
system crash, or not included in a selective dump (ANALYZE/CRASH_DUMP), 
then some displays may be incomplete or unavailable. 


Please see descriptions of the individual qualifiers for details not included in the 
syntax definition. 


SHOW PROCESS 
Select which process to show: 


process-name 
ALL 
/ADDRESS=pcb_address 
/ID=nn 

/INDEX=nn 

/NEXT 

/SYSTEM 


Select what to show about a process (next page): 


Stacked entries in braces followed by § are synonyms. 
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/ALL 
/BUFFER_OBJECTS 
/CHANNELS [/FID_ONLY] 
/FANDLES 


/IMAGES - { ra \ 


/LOCKS [/BRIEF] 


=ALL 
range |/PTE_ADDRESS] 
/PO (D) 
/P1 
/P2 
/PT 


/GSTX=index 


/PAGE TABLES /INVALID_PEN [=option] 
tiger - \s /NONMEMORY_PFN [=option] 


/SECTION_INDEX=n 


{ /RDE [=id] \s 
/REGIONS [=id] 


ILA 
/L2 
/L3 (D) 


/PERSONA|=aaddress] [/RIGHTS[/AUTHORIZED]] 
/PHD 


{ /PROCESS_SECTION_ TABLE } § rede 


/PST /SECTION_INDEX=n 
/PCB 
/BRIEF 
{ FREE 
/UNUSED 
55 /HEADER 
= /MAXIMUM_BYTES [=n] 
=P} 
/POOL {= /RING_BUFFER[=ALL] 


range /STATISTICS 
/SUBTYPE=packet-type 
/TYPE=packet-type 


/SUMMARY 


/RDE [=id] 

/REGIONS [=id] S 
/REGISTERS 
/RMS [=option [, .. . J] 
/SEMAPHORE 
/THREADS 
/TQE [=ALL] 
/UNWIND_TABLE [=ALL] 


/WORKING_SET_LIST [=option] § 
/WSL [=option] 
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ALL 
Information about all processes that exist in the system. 


process-name 

Name of the process for which information is to be displayed. Use of the process- 
name parameter or one of the /ADDRESS, /ID, /INDEX, /NEXT, or /SYSTEM 
qualifiers causes the SHOW PROCESS command to perform an implicit SET 
PROCESS command, making the indicated process the current process for 
subsequent SDA commands. 


When you analyze a crash dump from a multiprocessing system, changing process 
context may require a switch of CPU context as well. When you issue a SET 
PROCESS command, SDA automatically changes its CPU context to that of the 
CPU on which that process is, or was most recently, current. You can determine 
the names of the processes in the system by issuing a SHOW SUMMARY 
command. 


The process-name can contain up to 15 uppercase letters, numerals, the 
underscore (_), dollar sign, colon (:), and some other printable characters. If 
it contains any other characters (including lowercase letters), you may need to 
enclose the process-name in quotation marks (" "). 


/ADDRESS=pcb-address 
Specifies the process control block (PCB) address of a process in order to display 
information about the process. 


/ALL 
Displays all information shown by the following qualifiers: 


/BUFFER_OBJECTS 
/CHANNELS 

/FANDLES 

AMAGES=ALL 

/LOCKS 
/PAGE_TABLES=ALL 

/PCB 

/PERSONA/RIGHTS 

/PHD 
/POOL/HEADER/RING_BUFFER 
/PROCESS_SECTION_TABLE 
/REGIONS 

/REGISTERS 

/RMS 

/SEMAPHORE 

/THREADS 

/TQE 

/UNWIND_TABLE (164 only.) 
/WORKING_SET_LIST 


/AUTHORIZED 

Used with the /PERSONA/RIGHTS qualifiers. See the 
/PERSONA/RIGHTS/AUTHORIZED description for the use of the /AUTHORIZED 
qualifier. 
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/BRIEF 

When used with the /LOCKS qualifier, causes SDA to display each lock owned 
by the current process in brief format, that is, one line for each lock. When used 
with the /POOL qualifier, causes SDA to display only general information about 
process pool and its addresses. 


/BUFFER_OBJECTS 
Displays all the buffer objects that a process has created. 


/CHANNELS 
Displays information about the I/O channels assigned to the process. 


/FANDLES 
Displays the data on the process’s fast I/O handles. 


/FID_ONLY 

When used with /CHANNEL or /PROCESS_SECTION_TABLE (/PST), causes 
SDA to not attempt to translate the FID (File ID) to a file name when invoked 
with ANALYZE/SYSTEM. 


/FREE 

When used with /POOL, displays the entire contents, both allocated and free, of 
the specified region or regions of pool. Use the /FREE qualifier with a range to 
show all of the used and free pool in the given range. 


/GSTX=index 
When used with the /PAGE_TABLES qualifier, displays only page table entries 
for the specific global section. 


/HEADER 
When used with /POOL, displays only the first 16 bytes of each data packet found 
within the specified region or regions of pool. 


AMAGES [={namel| ALL}] 

For all images in use by this process, displays the address of the image control 
block, the start and end addresses of the image, the activation code, the protected 
and shareable flags, the image name, and the major and minor IDs of the image. 
The /IMAGES = ALL qualifier also displays the base, end, image offset, section 
type, and global pointer for all (164) or all installed resident (Alpha) images in 
use by this process. The /IMAGE=name qualifier displays this information for 
just the specified images; name may contain wildcards. 


See the HP OpenVMS Linker Utility Manual and the Install utility chapter 
in the HP OpenVMS System Management Utilities Reference Manual for more 
information on images installed using the /RESIDENT qualifier. 


AD=nn 

ANDEX=nn 

Specifies the process for which information is to be displayed by its index into 
the system’s list of software process control blocks (PCBs), or by its process 
identification (ID). You can supply the following values for nn: 


e The process index itself. 
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e The process identification (PID) or extended PID longword, from which SDA 
extracts the correct index. You can specify the PID or extended PID of any 
thread of a process with multiple kernel threads. Any thread-specific data 
displayed by SHOW PROCESS will be for the given thread. 


To obtain these values for any given process, issue the SDA command SHOW 
SUMMARY/THREADS. You can use the /ID=nn and /INDEX=nn qualifiers 
interchangeably. 


/INVALID_PFN [=option] 

The /INVALID_PFN qualifier, which is valid only on platforms that supply an I/O 
memory map, causes SDA to display only page table entries that map to PFNs 
that are in neither the system’s private memory, nor Galaxy-shared memory, nor 
are I/O access pages. Use of /INVALID_PFN implies /PAGE_TABLES. 


The /INVALID_PFN qualifier allows two optional keywords, READONLY and 
WRITABLE. If neither keyword is given, all relevant pages are displayed. 

If you specify READONLY, only pages marked for no write access are 
displayed. If you specify WRITABLE, only pages that allow write access are 
displayed. For example, SHOW PROCESS ALL/PAGE_TABLE=ALL/INVALID_ 
PFN=WRITABLE would display all process pages (for all processes) whose 
protection allows write, but which map to PFNs that do not belong to this system. 


/L1 

/L2 

/L3 (D) 

When used with the /PAGE_TABLES qualifier, /L1, /L2, /L3 displays the page 
table entries at the level specified. /L3 is the default. 


/LOCKS [/BRIEF] 
Displays the lock management locks owned by the current process. 


The /LOCKS |[/BRIEF] qualifier produces a display similar in format to that 
produced by the SHOW LOCKS command. See also the /BRIEF qualifier 
description. Table 4-6 contains additional information. 


/MAXIMUM_BYTES [=n] 
When used with /POOL, displays only the first n bytes of a pool packet; if you 
specify /MAXIMUM_BYTES without a value, the default is 64 bytes. 


/NEXT 

Locates the next valid process in the system’s process list and selects that process. 
If there are no further valid processes in the system’s process list, SDA returns 
an error. 


/NONMEMORY_PFN [=option] 

The /NONMEMORY_PFN qualifier causes SDA to display only page table entries 
that are in neither the system’s private memory nor in Galaxy-shared memory. 
Use of /NONMEMORY_PFN implies /PAGE_TABLES. 


The /NONMEMORY_PFN qualifier allows two optional keywords, READONLY 
and WRITABLE. If neither keyword is given, all relevant pages are displayed. 
If you specify READONLY, only pages marked for no write access are displayed. 
If you specify WRITABLE, only pages that allow write access are displayed. 
For example, SHOW PROCESS ALL/PAGE_TABLE=ALL/NONMEMORY_ 
PFN=WRITABLE would display all process pages (for all processes) whose 
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protection allows write, but which map to PFNs that are in neither the system’s 
private memory nor Galaxy-shared memory. 


/PO (D) 

/P1 

/P2 

When used with the /PAGE_TABLES qualifier, /P0, /P1, /P2 displays only page 
table entries for the specified region. The default is /PO. 


/PAGE_TABLES 

Displays the page tables of the process PO (process), P1 (control), P2, or PT (page 
table) region, or, optionally, page table entries for a range of addresses. You can 
use /PAGE_TABLES=ALL to display page tables of all four regions. With /Ln, 
the page table entries at the level specified by /L1, /L2, or /L3 (the default) are 
displayed. 

With /RDE=id or /REGIONS=id, SDA displays the page tables for the address 
range of the specified address region. When you do not specify an ID, the page 
tables are displayed for all the process-permanent and user-defined regions. 


You can express a range using the following syntax: 


m Displays the single page table entry that corresponds to virtual address m. 


m:n Displays the page table entries that correspond to the range of virtual 
addresses from m to n. 


m;n Displays the page table entries that correspond to a range of n bytes, 
starting at virtual address m. 


Page Protections and Access 


See Section 2.8 for information on page protections and access. 


With the /GSTX=index qualifier, SDA displays only the page table entries for the 
pages in the specified global section. 


With the /PTE_ADDRESS qualifier, SDA treats the specified range as PTE 
addresses instead of virtual addresses. 


With the /SECTION_INDEX=n qualifier, SDA displays only the page table entries 
for the pages in the specified process section. 


/PCB 
Displays the information contained in the process control block (PCB). This is the 
default behavior of the SHOW PROCESS command. 


/PERSONA [=address] 
Displays all persona security blocks (PSBs) held in the PERSONA ARRAY of the 
process, and then lists selected information contained in each initially listed PSB. 


The selected information includes the contents of the following cells inside the 
PSB: 


Flags 
Reference count 
Execution mode 
Audit status 
Account name 


UIC 
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Privileges 
Rights enabled mask 


If you specify a PSB address, the above information is provided for that specific 
PSB only. 


/PERSONA/RIGHTS 

Displays all the /PERSONA |[=address] information and additional selected 
information, including all the Rights and their attributes currently held and 
active for each persona security block (PSB). 


/PERSONA/RIGHTS/AUTHORIZED 

Displays all the /PERSONA |[=address] information and additional selected 
information, including all the Rights and their attributes authorized for each 
persona security block (PSB). 


/PHD 
Lists the information included in the process header (PHD). 


/POOL 
Displays the dynamic storage pool of the process PO (process) and/or P1 (control) 
region, or, optionally a range of addresses. 


You can express a range using the following syntax: 


m:n Displays the process pool in the range of virtual addresses from m to n. 
m;n Displays process pool in a range of n bytes, starting at virtual address m. 


/PPT 
Is a synonym for /PAGE_TABLES. 


/PROCESS_SECTION_TABLE [/SECTION_INDEX=/a][/FID_ONLY] 

Lists the information contained in the process section table (PST). The 
/SECTION_INDEX=id qualifier used with /PROCESS_SECTION_TABLE displays 
the process section table entry for the specified section. 


/PST 
Is a synonym for /PROCESS_SECTION_TABLE. 


/PT 
When used with the /PAGE_TABLES qualifier, displays the page table entries for 
the page table space of the process. 


/PTE_ADDRESS 
When used with the /PAGE_TABLES qualifier, specifies that the range is of PTE 
addresses instead of the virtual addresses mapped by the PTE. 


/RDE [=id] 

/REGIONS [=id] 

Lists the information contained in the process region table for the specified 
region. If you do not specify a region, the entire table is displayed, including the 
process-permanent regions. You can use the qualifiers /RDE [=id] and /REGIONS 
[=id] interchangeably. When used with the /PAGE_TABLES, causes SDA to 
display only the page tables for the region given or all regions. 


SDA Commands 4-179 


SDA Commands 
SHOW PROCESS 


/REGISTERS 

Lists the hardware context of the process, as reflected in the process registers 
stored in the hardware privileged context block (HWPCB), in its kernel stack, and 
possibly, in its PHD. 


/RIGHTS 
Used with the /PERSONA qualifier. See the /PERSONA/RIGHTS description for 
use of the /RIGHTS qualifier. 


/RING_BUFFER[=ALL] 

Displays the contents of the process-pool history ring buffer. Entries are displayed 
in reverse chronological order (most recent to least recent). If you specify /RING_ 
BUFFER without the ALL keyword, displays only unmatched current allocations 
and deallocations. Use /RING_BUFFER=ALL to display matched allocations and 
deallocations and any non-current entries not yet overwritten. 


/RMS [=option{,...]] 

Displays certain specified RMS data structures for each image I/O or process- 
permanent I/O file the process has open. To display RMS data structures for 
process-permanent files, specify the PIO option to this qualifier. 


SDA determines the structures to be displayed according to either of the following 
methods: 


e If you provide the name of a structure or structures in the option parameter, 
SHOW PROCESS/RMS displays information from only the specified 
structures. (See Table 4—2 in the SET RMS command description for a 
list of keywords that you can supply as options.) 


e Ifyou do not specify an option, SHOW PROCESS/RMS displays the current 
list of options as shown by the SHOW RMS command and set by the SET 
RMS command. 


/SECTION_INDEX=n 

When used with the /PAGE_TABLES qualifier, displays the page table for the 
range of pages in the specified process section. You can also specify one of the 
qualifiers /L1, /L2, or /L3. 


When used with the /PROCESS_SECTION_TABLE qualifier, displays the PST for 
the specified process section. 


The /SECTION_INDEX=n qualifier is ignored if you do not specify either the 
/PAGE_TABLES or the /PROCESS_SECTION_TABLE qualifier. 


/SEMAPHORE 
Displays the Inner Mode Semaphore for a multithreaded process. 


/STATISTICS 
When used with /POOL, displays statistics on the free list(s) in process pool. 


/SUBTYPE=packet-type 

When used with /POOL, displays only packets of the specified subtype. This 
qualifier is interchangeable with the /TYPE qualifier. See the /TYPE qualifier for 
information on packet types. 


/SUMMARY 
When used with /POOL, displays only an allocation summary for each packet 


type. 
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/SYSTEM 

Displays the system’s process control block. The system PCB and process header 
(PHD) parallel the data structures that describe processes. They contain the 
system working set, global section table, global page table, and other systemwide 
data. 


/THREADS 
Displays the software and hardware context of all the threads associated with the 
current process. 


/TQE [=ALL] 

Displays all timer queue entries associated with the current process. If specified 
as /TQE, a one-line summary is output for each TQE. If specified as /TQE=ALL, a 
detailed display of each TQE is output. See Table 4-31 for an explanation of TQE 
types in the one-line summary. 


/TYPE=packet-type 

When used with /POOL, displays only packets of the specified type. This qualifier 
is interchangeable with the /SUBTYPE qualifier. Pool packet types found in the 
process pool may include logical names (LOG) and image control blocks (IMCB). 


/UNUSED 
When used with /POOL, displays only free packets. 


/UNWIND_TABLE [=ALL] 

If specified without the ALL keyword, displays the master unwind table for the 
process. SHOW PROCESS/UNWIND=ALL displays the details of every process 
unwind descriptor. To look at unwind data for a specific PC in process space, use 
SHOW UNWIND address. 


/WORKING_SET_LIST [={PPT|PROCESS|LOCKED! GLOBAL | MODIFIED 
| n}] 

Displays the contents of the requested entries of the working set list for 
the process. If you do not specify an option, then all working set list 
entries are displayed. Table 4-19 shows the options available with SHOW 
PROCESS/WORKING_SET_LIST. 


Table 4-19 Options for the (WORKING_SET_LIST Qualifier 


Options Results 

PPT Displays process page table pages 

PROCESS Displays process-private pages 

LOCKED Displays pages locked into the process’s working set 

GLOBAL Displays global pages currently in the working set of the process 
MODIFIED Displays working set list entries marked modified 

n Displays a specific working set list entry, where n is the working 


set list index (WSLX) of the entry of interest 


WSL 
Synonym for WORKING_SET_LIST. 
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Description 


The SHOW PROCESS command displays information about the process specified 
by process-name, the process specified in the /ID or /INDEX qualifier, the next 
process in the system’s process list, the system process, or all processes. The 
SHOW PROCESS command performs an implicit SET PROCESS command under 
certain uses of its qualifiers and parameters, as noted previously. By default, the 
SHOW PROCESS command produces information about the SDA current process, 
as defined in Section 2.5. 


The default of the SHOW PROCESS command provides information taken from 
the software process control block (PCB) and the kernel threads block (KTB) of 
the SDA current thread. This is the first display provided by the /ALL qualifier 
and the only display provided by the /PCB qualifier. This information describes 
the following characteristics of the process: 


e Software context 

e Condition-handling information 

e Information on interprocess communication 

e Information on counts, quotas, and resource usage 


Among the displayed information are the process PID, EPID, priority, job 
information block (JIB) address, and process header (PHD) address. SHOW 
PROCESS also describes the resources owned by the process, such as event 
flags and mutexes. The “State” field records the current scheduling state for 
the thread, and indicates the CPU ID of any thread whose state is CUR. See 
Table 4-30 for a list of all possible states. 


The /THREADS qualifier (also part of SHOW PROCESS/ALL), displays 
information from the KTBs of all threads in the process, instead of only the 
SDA current thread. 


The SHOW PROCESS/ALL command displays additional process-specific 
information, also provided by several of the individual qualifiers to the command. 


The process registers display, also produced by the /REGISTERS qualifier, 
describes the process hardware context, as reflected in its registers. The registers 
displayed are those of the SDA current thread, or of all threads if either the 
/THREADS or the /ALL qualifier have been specified. 


A process hardware context is stored in the following locations: 


e Ifthe process is currently executing on a processor in the system (that is, 
in the CUR scheduling state), its hardware context is contained in that 
processor’s registers. (That is, the process registers and the processor’s 
registers contain identical values, as illustrated by a SHOW CPU command 
for that processor or a SHOW CRASH command, if the process was current at 
the time of the system failure.) 


e Ifthe process is not executing, its privileged hardware context is stored in the 
part of the PHD known as the HWPCB. Its integer register context is stored 
on its kernel stack. Its floating-point registers are stored in its PHD. 


The process registers display first lists those registers stored in the HWPCB, 
kernel stack, and PHD (“Saved process registers”). If the process to be displayed 
is currently executing on a processor in the system, the display then lists the 
processor’s registers (“Active registers for the current process”). In each section, 
the display lists the registers in groups. 
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For Alpha: 

e Integer registers (RO through R29) 

e Special-purpose registers (PC and PS) 

e Stack pointers (KSP, ESP, SSP, and USP) 

e Page table base register (PTBR) 

e AST enable and summary registers (ASTEN and ASTSR) 
e Address space number register (ASN) 

For 164: 


e Integer registers (R1 through R11, R13 through R31). Note that R1 is 
displayed as GP (Global Pointer) and R12 is omitted. 


e Special-purpose registers (PC, PSR, ISR) 

e Stack pointers (KSP, ESP, SSP, and USP) 

e Register stack pointers (KBSP, EBSP, SBSP, and UBSP) 

e Page table base register (PTBRO) 

e AST enable and summary registers (ASTEN and ASTSR) 

e Address space number registers (ASNO) 

e Floating point registers (F2 through F31, possibly F32 through F127) 


The semaphore display, also produced by the (SEMAPHORE qualifier, provides 
information on the inner-mode semaphore used to synchronize kernel threads. 
The PC history log, recorded if the system parameter SYSTEM_CHECK is 
enabled, is also displayed. 


The process header display, also produced by the /PHD qualifier, provides 
information taken from the PHD, which is swapped into memory when the 
process becomes part of the balance set. Each item listed in the display reflects a 
quantity, count, or limit for the process use of the following resources: 


e Process memory 

e The pager 

e The scheduler 

e Asynchronous system traps 
e I/O activity 

e CPU activity 


The working set information and working set list displays, also produced by 
the /WORKING_SET_LIST qualifier, describe those virtual pages that the process 
can access without a page fault. After a brief description of the size, scope, and 
characteristics of the working set list itself, SDA displays information for each 
entry in the working set list as shown in Table 4—20. 
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Table 4—20 Working Set List Entry Information in the SHOW PROCESS Display 


Column Contents 


INDEX Index into the working set list at which information for this entry 
can be found 


ADDRESS Virtual address of the page that this entry describes 
STATUS Four columns that list the following status information: 


e Page status of VALID 
e Type of physical page (See Table 4—11) 
e Indication of whether the page has been modified 


e Indication of whether the page is locked into the working set 


When SDA locates either one or more unused working set entries, or entries that 
do not match the specified option, it issues the following message: 


---- n entries not displayed 
In this message, n is the number (in decimal) of contiguous entries not displayed. 


The process section table information and process section table displays, 
also produced by the /PROCESS_SECTION_TABLE or /PST qualifier, list each 
entry in the process section table (PST) and display the offsets to, and the indexes 
of, the first free entry and last used entry. 


SDA displays the information listed in Table 4—21 for each PST entry. 


Table 4-21 Process Section Table Entry Information in the SHOW PROCESS 


Display 
Part Definition 
INDEX Index number of the entry. Entries in the process section 


table begin at the highest location in the table, and the table 
expands toward lower addresses. 


ADDRESS Address of the process section table entry. 

SECTION Virtual address that marks the beginning of the first page of 

ADDRESS the section described by this entry. 

CCB Address of the channel control block on which the section file 
is open. 

PAGELETS Length of the process section. This is in units of pagelets, 
except for a PFN-mapped section in which the units are pages. 

VBN Virtual block number. The number of the file’s virtual block 
that is mapped into the section’s first page. 

WINDOW Address of the window control block on which the section file 
is open. 


(continued on next page) 
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Table 4—21 (Cont.) Process Section Table Entry Information in the SHOW 
PROCESS Display 


Part Definition 

REFCNT Number of pages of this section that are currently mapped. 

FLINK Forward link. The pointer to the next entry in the PST list. 

BLINK Backward link. The pointer to the previous entry in the PST 
list. 

FLAGS Flags that describe the access that processes have to the 


process section. 


In addition, for each process section that has an associated file, the device and/or 
file name is displayed. For details of this display, see Table 4—23. 


The regions display, also produced by the either of the /RDE or /REGIONS 
qualifiers, shows the contents of the region descriptors. This includes the three 
default regions (PO, P1, P2), plus any others created by the process. A single 
region will be displayed if you specify its identifier. The information displayed 
for each region includes the RDE address, the address range of the region, its 
identifiers and protection, and links to other RDEs. 


If you use the /PAGE_TABLE or /PPT qualifer with /RDE or /REGION, the page 
table for the region is also displayed, as described below. 


The PO page table, P1 page table, P2 page table, and PT page table 
displays, also produced by the /PAGE_TABLES qualifier, display listings of the 
process page table entries in the same format as that produced by the SHOW 
PAGE_TABLE command (see Tables 4—7 through Table 4-12). 


The RMS display, also produced by the /RMS qualifier, provides information 

on the RMS internal data structures for all RMS-accessed open files. The data 
structures displayed depend on the current setting of RMS options, as described 
under the SET RMS command and Table 42. 


The locks display, also produced by the /LOCKS qualifier, provides information 
on the locks held by the process. For a full description of the information 
displayed for process locks, see the SHOW LOCKS command and Table 4-6. You 
can also specify the /BRIEF qualifier, which provides single-line summary of each 
process lock; however, no other qualifiers from SHOW LOCKS apply to SHOW 
PROCESS/LOCKS. 


The process active channels display, also produced by the /CHANNEL qualifier, 
displays the information in Table 4—22 for each I/O channel assigned to the 
process. 


Table 4-22 Process Active Channels in the SHOW PROCESS Display 


Column Contents 
Channel Number of the channel. 
CCB The address of the channel control block (CCB). 


(continued on next page) 


SDA Commands 4-185 


SDA Commands 
SHOW PROCESS 


Table 4—22 (Cont.) Process Active Channels in the SHOW PROCESS Display 


Column Contents 

Window Address of the window control block (WCB) for 
the file if the device is a file-oriented device; zero 
otherwise. 

Status Status of the device: “Busy” if the device has an 


Device/file accessed 


I/O operation outstanding; “Dpnd” if the device is 
deaccess pending; blank otherwise. 

Name of the device and, if applicable, name of 
the file being accessed on that device. 


The information listed under the heading “Device/file accessed” varies from 
channel to channel and from process to process. SDA displays certain information 
according to the conditions listed in Table 4—23. 


Table 4—23 Process I/O Channel Information in the SHOW PROCESS Display 


Information Displayed’ 


Type of Process 


deuu: 


dcuu:filespec 


dcuu:(file-id) 


(section file) 


SDA displays this information for devices that are not 
file structured, such as terminals, and for processes that 
do not open files in the normal way. 


SDA displays this information only if you are examining 
a running system, and only if your process has enough 
privilege to translate the file-id into the filespec. 

The file-id no longer points to a valid filespec, as when 
you look at a dump from another system; or the process 
in which you are running SDA does not have enough 
privilege to translate the file-id into the corresponding 
filespec. 

The file in question is mapped into the process’s memory. 


This table uses the following conventions to identify the information displayed: 


dcuu:(file-id )filespec 
where: 


dcuu: is the name of the device. 
file-id is the RMS file identification, or 
filespec is the full file specification, including directory name. 


The images display, also produced by the /IMAGES qualifier, describes the 
activated images in the process. SDA displays the information listed in 
Table 4—24 for each image, plus a summary line giving the total image and 


total page counts. 
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Table 4-24 Image Information in the SHOW PROCESS Display 


Item 


Description 


Image Name 
Link Time 
Section Type! 


Start? 


End? 


Type 


File ID! 

IMCB 

GP? 

Sym Vect! 

Maj, Minor ID}, 2 

Maj, Min ID, Match!, 3 


Base! 


End! 


ImageOff! 


The name of the image. 
The date and time the image was linked. 


For shareable images, the data for each image 
section is displayed on a separate line. For 
privileged shareable images, data for the change 
mode vector is also displayed on a separate line. 
Start address of the image in process memory. For 
resident shareable images, this is the start address 
of the process-space portion of the image. 

End address of the image in process memory. For 
resident shareable images, this is the end address of 
the process-space portion of the image. 

The image type and/or activation method, plus 
"PROT" for protected images and "SHR" for 
shareable images. 

The File ID for the image file. No attempt is made 
to translate this to a filename. 


The address of the Image Management Control 
Block. 


The Global Pointer for the image. 
The address of the image’s symbol vector, if any. 
The major and minor revision IDs for the image. 


The major and minor revision IDs for the image, 
plus the match control bits. 


For Alpha shareable images and all I64 images, 
the base address of each image section and/or the 
change mode vector. 


For Alpha shareable images and all 164 images, the 
end address of each image section and/or the change 
mode vector. 

For Alpha shareable images and all 164 images, the 
virtual offset within the image file for each image 
section. 


1These items are only displayed with SHOW PROCESS/IMAGE=ALL or SHOW PROCESS/ALL. 


2 Alpha only. 
3164 only. 


The buffer objects display, also produced by the /BUFFER_OBJECTS qualifier, 
describes the buffer objects in use by the process. Information displayed by SDA 
for each buffer object includes its address, access mode, size, flags, plus the base 
virtual address of the object in process space and system space. 


The fast I/O handles display, also produced by the /FANDLES qualifier, 
describes the fast I/O handles used by the process. Information displayed by 
SDA includes the address and size of the fast I/O handle vector header, then the 
address, corresponding IRP, state, and buffer object handles for each fast I/O 
handle, plus information on free vector entries. 
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The persona display, also produced by the /PERSONA qualifier, describes the 
Persona status block data structures. The default output of /PERSONA consists 
of summary information for all personae in use by the process (the PSB address, 
flags, user name) and information for each persona (privilege masks, UIC, and so 
on). When you specify /PERSONA/RIGHTS (as in SHOW PROCESS/ALL), all the 
rights currently held and active for each persona are also displayed. When you 
specify /PERSONA/RIGHTS/AUTHORIZED, all the rights authorized for each 
persona are displayed instead. 


The pool display, also produced by the /POOL qualifier, describes the PO and P1 
process pools. The default output of /POOL is the entire contents of each used 
block of pool. When you specify /POOL/HEADER (as in SHOW PROCESS/ALL), 
only the first 16 bytes of each used pool block is displayed. By default, all pool in 
either PO or P1 is displayed. You can limit this using /POOL=P0 or /POOL=P1. 
See the description of the SHOW POOL command for explanations of other 
qualifiers. 


The Timer Queue Entry (TQE) display, also produced by the /TQE qualifier, 
describes all timer queue entries that affect the process. The default display (as 
in SHOW PROCESS/ALL) is a one-line summary of each TQE. If you specify 
/TQE=ALL, a detailed display of each TQE is given. No other qualifiers from the 
SHOW TQE command apply to SHOW PROCESS/TQE. 
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Examples 


1. 


SDA> SHOW PROCESS 
Process index: 0028 Name: SYSTEM Extended PID: 000000E8 


Process status: 02040001 RES,PHDRES, INTER 

status2: 00000000 
PCB address 81444A40 JIB address 81443600 
PHD address 821AA000 Swapfile disk address 00000000 
KTB vector address 81444D2C HWPCB address 821AA080 
Callback vector address 00000000 Termination mailbox 0000 
Master internal PID 00030028 Subprocess count 0 
Creator extended PID 00000000 Creator internal PID 00000000 
Previous CPU Id 00000000 Current CPU Id 00000000 
Previous ASNSEQ 0000000000000003 Previous ASN 0000000000000017 
Initial process priority 4 # open files remaining 100/100 
Delete pending count 0 Direct I/O count/limit 150/150 
UIC [00001,000004] Buffered I/O count/limit 149/150 
Abs time of last event 01F1A51D BUFIO byte count/limit 99424/99808 
# of threads 1 ASTs remaining 248/250 
Swapped copy of LEFC0 00000000 Timer entries remaining 20/20 
Swapped copy of LEFC1 00000000 Active page table count 0 
Global cluster 2 pointer 00000000 Process WS page count 43 
Global cluster 3 pointer 00000000 Global WS page count 28 


Thread index: 0000 

Current capabilities: System: 0000000C QUORUM, RUN 
User: 00000000 

Permanent capabilities: System: 0000000C QUORUM, RUN 
User: 00000000 


Current affinities: 00000000 
Permanent affinities: 00000000 
Thread status: 02040001 

status2: 00000000 
KTB address 81444040 HWPCB address 821AA080 
PKTA address 7FFEFF98 Callback vector address 00000000 
Internal PID 00030028 Callback error 00000000 
Extended PID 000000E8 Current CPU id 00000000 
State LEF Flags 00000000 
Base priority 4 Current priority 5 
Waiting EF cluster 0 Event flag wait mask DFFFFFFF 
CPU since last quantum FFF8 Mutex count 0 
ASTs active NONE 


The SHOW PROCESS command displays information taken from the software 
PCB of SYSTEM, the SDA current process. According to the State field in the 
display, process SYSTEM is in Local Event Flag Wait. 
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2.SDA> SHOW PROCESS/ALL 


Process index: 0013 Name: ACME | 


Process status: 00040011 

status2: 00000010 
PCB address 81AFF480 
PHD address 84166000 
KTB vector address 81B00900 
Callback vector address 81AFF8CO 
Master internal PID 00010013 
Creator extended PID 00000000 
Previous CPU Id 00000004 
Previous ASNSEQ 000000000000003D 
Initial process priority 8 
Delete pending count 0 
UIC [00001,000004] 
Abs time of last event 0012D67F 
# of threads 2 
Swapped copy of LEFCO 00000000 
Swapped copy of LEFC1 00000000 


Global cluster 2 pointer 00000000 
Global cluster 3 pointer 00000000 


Process index: 0013 Name: ACME | 


Thread index: 0000 


Current capabilities: System: 
User: 
Permanent capabilities: System: 
User: 
Current affinities: 00000000 
Permanent affinities: 00000000 
Thread status: 00040011 
status2: 00000010 
KTB address 815D0880 
PKTA address 7EFEFF98 
Internal PID 00010013 
Extended PID 00000413 
State HIB 
Base priority 8 
Waiting EF cluster 0 
CPU since last quantum 0286 
ASTs active NONE 


Current process registers 


RO = 00000000.00000001 R1 = 
R3 = 00000000.7BC1CFFO R4 = 
R6 = 00000000.00000080 R7 = 
R9 = 00000000.00000000 R10 = 
R12 = 00000000.0009DCc80 R13 = 
R15 = 00000000.7BC65558 R16 = 
R18 = 00000000.00000000 R19 = 
R21 = 00000000.00000006 R22 = 
R24 = 00000000.0009BBE8 R25 = 
R27 = FFFFFFFF.810CD888 R28 = 
PC = FFFFFFFF.80001934 PS = 
KSP = 00000000.7FFAIEFO ESP = 
USP = 00000000.0009BC20 PTBR = 
AST{SR/EN} = 0000000F ASN = 
FO = 00000000.00000000 F1 = 
F3 = 00000000.00000000 F4 = 
Fé = 00000000.00000000 F7 = 
F9 = 00000000.00000000 F10 = 
F12 = 00000000.00000000 F13 = 
F15 = 00000000.00000000 F16é = 
F18 = 00000000.00000000 F19 = 
F21 = 00000000.00000000 F22 = 
F24 = 00000000.00000000 F25 = 
F27 = 00000000.00000000 F28 = 
F30 = 00000000.00000000 FPCR = 
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RES , PSWAPM, PHDRES 

TCB 
JIB address 8177E440 
Swapfile disk address 00000000 
HWPCB address 84166080 
Termination mailbox OooF 
Subprocess count 0 
Creator internal PID 00000000 
Current CPU Id 00000004 
Previous ASN 0000000000000002 
# open files remaining 97/100 
Direct I/O count/limit 200/200 
Buffered I/O count/limit 199/200 
BUFIO byte count/limit 66272/66272 
ASTs remaining 199/200 
Timer entries remaining 64/64 
Active page table count 0 
Process WS page count 350 
Global WS page count 100 


SERVER Extended PID: 00000413 


0000002C QUORUM, RUN 


00000000 
0000002C QUORUM, RUN 
00000000 
HWPCB address 83F62080 
Callback vector address 815BB780 
Callback error 00000000 
Current CPU id 00000000 
Flags 00000080 
Current priority 13 
Event flag wait mask 00130013 
Mutex count ie) 
FFFFFFFF.815D0880 R2 = 00000000. 7BC1CFFO 
00000000.0009D740 R5 = 00000000. 7BC22E38 
00000000.00000040 R8 = 00000000.00000001 
00000000.00000000 R11 = 00000000.00000004 
FFFFFFFF.810D0B20 R14 = 00000000.7BC230BO 
00000000.00000001 R17 = 00000000.0009BBE8 
00000000.00000000 R20 = FFFFFFFF.FFFFFFFE 
00000000.00000000 R23 = 00000000.00000001 
00000000.00000000 R26 = FFFFFFFF.801270C8 
00000000.00000006 FP = 00000000.0009BC20 
00000000.0000001B 
00000000.7FFA6000 SSP = 00000000.7FFAE000 


00000000.00004F65 
00000000.000000FD 


00000000.00000000 F2 = 00000000.00000000 
00000000.00000000 F5 = 00000000.00000000 
00000000.00000000 F8 = 00000000.00000000 
00000000.00000000 F11l = 00000000.00000000 
00000000.00000000 F14 = 00000000.00000000 
00000000.00000000 F17 = 00000000.00000000 
00000000.00000000 F20 = 00000000.00000000 
00000000.00000000 F23 = 00000000.00000000 
00000000.00000000 F26 = 00000000.00000000 
00000000.00000000 F29 = 00000000.00000000 
00000000.00000000 
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Thread index: 0001 


Current capabilities: System: 0000002C QUORUM, RUN 
User: 00000000 

Permanent capabilities: System: 0000002C QUORUM,RUN 
User: 00000000 


Current affinities: 00000000 
Permanent affinities: 00000000 
Thread status: 00040011 

status2: 00000010 
KTB address 8153DA80 HWPCB address 84026200 
PKTA address 40015F98 Callback vector address 815BB780 
Internal PID 00020013 Callback error 00000000 
Extended PID 00000813 Current CPU id 00000000 
State HIB Flags 00000000 
Base priority 8 Current priority 13 
Waiting EF cluster 0 Event flag wait mask 7FFFFFFF 
CPU since last quantum 0036 Mutex count 0 
ASTs active NONE 
Current process registers 
RO = 00000000.00000001 Rl = FFFFFFFF.815D0880 R2 = 00000000.7BC1CFFO 
R3 = 00000000.7BC1CFFO R4 = 00000000.000CB740 R5 = 00000000.7BC22E38 
R6 = 00000000.00000080 R7 = 00000000.00000040 R8 = 00000000.00000001 
RI = 00000000.00000000 R10 = 00000000.00000000 R11 = 00000000.00000004 
R12 = 00000000.000CBC80 R13 = FFFFFFFF.810D0B20 R14 = 00000000.7BC230B0 
R15 = 00000000.7BC65558 R16 = 00000000.00000001 R17 = 00000000.000C9BE8 
R18 = 00000000.00000000 R19 = 00000000.00000000 R20 = FFFFFFFF.FFFFFFFE 
R21 = 00000000.00000006 R22 = 00000000.00000000 R23 = 00000000.00000001 
R24 = 00000000.000C9BE8 R25 = 00000000.00000000 R26 = FFFFFFFF.801270C8 
R27 = FFFFFFFF.810CD888 R28 = 00000000.00000006 FP = 00000000.000C9C20 
PC = FFFFFFFF.80001934 PS = 00000000.0000001B 
KSP = 00000000.40003EFO ESP = 00000000.40008000 SSP = 00000000.4000C000 
USP = 00000000.000C9C20 PTBR = 00000000.00004F65 
AST{SR/EN} = 0000000F ASN = 00000000.000000F7 
FO = 00000000.00000000 F1 = 00000000.00000000 F2 = 00000000.00000000 
F3 = 00000000.00000000 F4 = 00000000.00000000 F5 = 00000000.00000000 
F6 = 00000000.00000000 F7 = 00000000.00000000 F8 = 00000000.00000000 
F9 = 00000000.00000000 F10 = 00000000.00000000 F11 = 00000000.00000000 
F12 = 00000000.00000000 F13 = 00000000.00000000 F14 = 00000000.00000000 
F15 = 00000000.00000000 F16 = 00000000.00000000 F17 = 00000000.00000000 
F18 = 00000000.00000000 F19 = 00000000.00000000 F20 = 00000000.00000000 
F21 = 00000000.00000000 F22 = 00000000.00000000 F23 = 00000000.00000000 
F24 = 00000000.00000000 F25 = 00000000.00000000 F26 = 00000000.00000000 
F27 = 00000000.00000000 F28 = 00000000.00000000 F29 = 00000000.00000000 
F30 = 00000000.00000000 FPCR = 00000000.00000000 


Process index: 0013 Name: ACME SERVER Extended PID: 00000413 


Inner Mode Semaphore Address: 84026000 
Owner: 0000 
Ownership Depth: 0000 
Tolerant count: 0000 
Flags: 0000 


History Buffer Is Empty 


Process index: 0013 Name: ACME SERVER Extended PID: 00000413 


First free PO VA 00000000.00822000 Accumulated CPU time 0000004D 
First free Pl VA 00000000.7AFCE000 Subprocess quota 10 
First free P2 VA 00000000.80000000 ASTs enabled KESU 
Free page file pages 1565 ASN sequence # 0000000000000075 
Page fault cluster size 4 AST limit 200 
Page table cluster size 1 Process header index 000D 
Flags 00000026 Backup address vector 0005C9A8 
Direct I/O count 17 PTs having locked WSLEs 3 
Buffered I/O count 55 PTs having valid WSLEs 10 
Limit on CPU time 00000000 Active page tables 10 
Maximum page file count 2500 Maximum active PTs 8 
Total page faults 345 Guaranteed fluid WS pages 20 
File limit 100 Extra dynamic WS entries 1529 
Local event flag cluster 0 E0000001 Local event flag cluster 1 80000000 
Timer queue limit 64 Pagefile refcnt 00000000.000000F0 


Page Table Base Register 00004F65 Virtual PT Base FFFFFEFC.00000000 
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First WSL entry 
First locked entry 
First dynamic entry 
Last entry replaced 
Last entry in list 


Working set list 


INDEX 


00000001 
00000002 
00000003 
00000004 
00000005 
00000006 
00000007 
00000008 


Locked entries: 
00000009 
0000000A 
0000000B 
0000000C 
0000000D 
0000000E 
0000000F 


Dynamic entries: 
00000010 
00000011 
00000012 
00000013 
00000014 
00000015 
00000016 


000001B4 
000001B5 
000001B6 
000001B7 
000001B8 
000001B9 
000001BA 
000001BB 
000001BC 


---- 1128 entries 


Name: ACME SERVER 


Extended PID: 


00000413 


00000001 Current authorized working set size 
00000009 Default (initial) working set size 
00000010 Maximum working set allowed (quota) 


000001BC 
00000624 


ADDRESS 


FFFFFEFD.BF6FC000 
FFFFFEFD.BF000000 
FFFFFEFC.001FE000 
00000000. 7FFA0000 
00000000. 7FFF0000 
FFFFFFFF .83F62000 
FFFFFFFF .83F64000 
FFFFFFFF .83F66000 


00000000. 7AFE0000 
00000000. 7AFE2000 
FFFFFFFF .84026000 
00000000. 7FFEE000 
00000000.40002000 
00000000.40014000 
00000000.40016000 


00000000. 7FFCE000 
FFFFFEFC.001EA000 
00000000. 7AFDC000 
00000000. 7FEB8000 
00000000. 7AFDE000 
00000000.7FFD0000 
00000000. 7FFBA000 


FFFFFEFC.00002000 
00000000.00806000 
00000000.006F2000 
00000000.006F4000 
00000000.00804000 
00000000.0081E000 
00000000.0080A000 
00000000.0080C000 
00000000.0081C000 
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STATUS 


VALID 
VALID 
VALID 
VALID 
VALID 
VALID 
VALID 
VALID 


VALID 
VALID 
VALID 
VALID 
VALID 
VALID 
VALID 


VALID 
VALID 
VALID 
VALID 
VALID 
VALID 
VALID 


VALID 
VALID 
VALID 
VALID 
VALID 
VALID 
VALID 
VALID 
VALID 


not displayed 


PPT(L1) 
PPT(L2) 
PPT(L3) 
PROCESS 
PROCESS 
PHD 
PHD 
PHD 


PROCESS 
PROCESS 
PHD 

PROCESS 
PROCESS 
PROCESS 
PROCESS 


PROCESS 
PPT(L3) 
PROCESS 
PROCESS 
PROCESS 
PROCESS 
PROCESS 


PPT(L3) 
PROCESS 
PROCESS 
PROCESS 
PROCESS 
PROCESS 
PROCESS 
PROCESS 
PROCESS 


WSLOCK 
WSLOCK 
WSLOCK 
MODIFIED WSLOCK 
WSLOCK 
WSLOCK 
WSLOCK 
WSLOCK 


WSLOCK 
WSLOCK 
WSLOCK 
WSLOCK 
WSLOCK 
WSLOCK 
WSLOCK 


WSLOCK 


MODIFIED 


WSLOCK 


3144 
1572 
3144 
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Process 


0000000B 
0000000B 


Last entry allocated 
First free entry 


Process section table 
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Index Address Section Address CCB Pagelets VBN Window Refcnt Flink Blink Flags 
00000001 81EF1FD8 00000000.00138000 7FF961A0 0000005F 00000004 814EEBO0 00000006 0009 0005 AMOD=KRNL 
File = DISK$X97D_R2Y:[VMS$COMMON.SYSLIB]VMS$VMS_ACMESHR.EXE;1 
00000002 81EF1FBO 00000000.7B96A000 7FF96280 00000001 00000003 814C70CO 00000000 OQO00A 000A CRF WRT AMOD=KRNL 
File = DISK$X97D_R2Y:[VMS$COMMON.SYSLIB]TRACE.EXE;1 
00000003 81EF1F88 00000000.00030000 7FF96020 000000B3 0000002F 814ED8CO 0000000C 0004 0004 AMOD=KRNL 
File = DISK$X97D_R2Y:[VMS$COMMON.SYSEXE]ACME_SERVER.EXE;1 
00000009 81EF1E98 00000000.003A8000 7FF961A0 00000003 O0000DD9 814EEBO00 00000001 0008 0001 AMOD=KRNL 
File = DISK$X97D_R2Y:[VMS$COMMON.SYSLIB]VMS$VMS_ACMESHR.EXE;1 
0000000A 81EF1E70 00000000.7B9FA000 7FF96280 00000013 00000345 814C70CO 00000000 0002 0002 CRF WRT AMOD=KRNL 
File = DISK$X97D_R2Y:[VMS$COMMON.SYSLIB]TRACE.EXE;1 
0000000B 81EF1E48 00000000.7BA0A000 00000000 00000001 00000358 814C70CO FFFFFFFF 000A 0002 CRF WRT AMOD=KRNL 
File = DISK$X97D_R2Y:[VMS$COMMON.SYSLIB]TRACE.EXE;1 
Process index: 0013 Name: ACME SERVER Extended PID: 00000413 
Process Region Table 
RDE Addr Flink Blink T Link Flags Protect Region Ident Starting Address Region Size First Free VA 
7FEBA328 7FEBA328 7FEBA328 00000000 0000000A 00000030 00000000.00000000 00000000.00000000 00000000.40000000 00000000.00822000 
7FEBA360 7FE99960 7FE99960 00000000 0000001D 00000030 00000000.00000001 00000000.40168000 00000000.3FE98000 00000000.7AFCE000 
7FEBA398 7FEBA398 7FEBA398 00000000 00000008 00000030 00000000.00000002 00000000.80000000 0O00006FB.80000000 00000000.80000000 
7FE99960 7FEBA360 7FEBA360 00000000 00000004 00000030 00000000.00000010 00000000.40000000 00000000.00168000 00000000.40018000 
Process index: 0013 Name: ACME SERVER Extended PID: 00000413 
Mapped Address PTE Address PTE Type Read Writ Bits GH PgTyp Loc Bak RefCnt Flink Blink 
eo------ 8 null pages: VA 00000000.00000000 PTE FFFFFEFC.00000000 
-to- 00000000.0000FFFF -to- FFFFFEFC.00000038 
00000000.00010000 FFFFFEFC.00000040 0000376A.00160F09 VALID KESU NONE M-U- 0 PROCESS ACTIVE FF000000.00000000 0001 00000000 0000003B 
7 null pages: VA 00000000.00012000 PTE FFFFFEFC.00000048 
-to- 00000000.0001FFFF -to- FFFFFEFC.00000078 
00000000.00020000 FFFFFEFC.00000080 00005060.0016FF09 VALID KESU KESU M-U- 0 PROCESS ACTIVE FF000000.00000000 0001 00000000 00000093 
00000000.00022000 FFFFFEFC.00000088 00005061.0016FF09 VALID KESU KESU M-U- 0 PROCESS ACTIVE FF000000.00000000 0001 00000000 00000094 
eoo----- 6 null pages: VA 00000000.00024000 PTE FFFFFEFC.00000090 
-to- 00000000.0002FFFF -to- FFFFFEFC.000000B8 
00000000.00030000 FFFFFEFC.000000C0 0000503D.00060F01 VALID KESU NONE --U- 0 PROCESS ACTIVE 00000003.00010000 0001 00000000 00000085 
00000000.00032000 FFFFFEFC.000000C8 0000503E.00060F01 VALID KESU NONE --U- 0 PROCESS ACTIVE 00000003.00010000 0001 00000000 00000086 
00000000.00034000 FFFFFEFC.000000D0 0000503F.00060F01 VALID KESU NONE --U- 0 PROCESS ACTIVE 00000003.00010000 0001 00000000 00000087 
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00000000.0081C000 FFFFFEFC.00002070 000038E4.0016FF09 VALID 
00000000.0081E000 FFFFFEFC.00002078 000038E1.0016FF09 VALID 
00000000.00820000 FFFFFEFC.00002080 00000000.0006FF00 DZERO 


VA 
-to- 


1007 null pages: 


129024 entries not VA 


-to- 


in memory: 


Mapped Address PTE Address 


KESU KESU M-U- 0 PROCESS ACTIVE 
KESU KESU M-U- 0 PROCESS ACTIVE 


KESU KESU --U- 0 


00000000.00822000 
00000000. 00FFFFFF 


00000000.01000000 
00000000.3FFFFFFF 


Read Writ Bits GH 


PgTyp 


PTE 
-to- 


PTE 
-to- 


FF000000.00000000 0001 00000000 000001BC 
FF000000.00000000 0001 00000000 000001B9 


FFFFFEFC.00002088 
FFFFFEFC.00003FF8 


FFFFFEFC.00004000 
FFFFFEFC.000FFFF8 


RefCnt 


Flink 


Blink 


-------- 1 null page: 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 


40002000 FFFFFEFC.00100008 
40004000 FFFFFEFC.00100010 
40006000 FFFFFEFC.00100018 
40008000 FFFFFEFC.00100020 
4000A000 FFFFFEFC.00100028 
4000C000 FFFFFEFC.00100030 
4000E000 FFFFFEFC.00100038 
40010000 FFFFFEFC.00100040 
40012000 FFFFFEFC.00100048 
40014000 FFFFFEFC.00100050 
40016000 FFFFFEFC.00100058 


000037DC. 
00000000. 
00003861. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
000037DD. 
000037DE. 


00101709 
00023700 
00123709 
00047F00 
00047F00 
00001100 
0000FF00 
O000FFO0 
0000FFO0 
OO10FFO9 
00103F09 


1012 null pages: 


118784 entries not in 


memory: 


1000 null pages: 


00000000. 
00000000. 
00000000. 


7AFD0000 FFFFFEFC.001EBF40 
7AFD2000 FFFFFEFC.001EBF48 
7AFD4000 FFFFFEFC.001EBF50 


000038BF. 
00003883. 
000038BE. 


OO16FFO9 
OO16FFO9 
OO16FFO9 


7FFEEO00O FFFFFEFC.001FFFB8 
7FFF0000 FFFFFEFC.001FFFCO 


00000000. 
00000000. 


00003753. 
OOOO4FAB. 


OO10FFO9 
10103F09 


7 null pages: 


PTE Address 


00000000.40000000 


KES- K--- MLK- 0 
KES- KE-- --E- 0 
KES- KE-- M-E- 0 
KESU KES- --S- 0 
KESU KES- --S- 0 
K--- K--- --K- 0 
KESU KESU --K- 0 
KESU KESU --K- 0 
KESU KESU --K- 0 
KESU KESU MLK- 0 
KESU KE-- MLK- 0 


00000000.40018000 
00000000.407FFFFF 


00000000.40800000 
00000000. 7A7FFFFF 


00000000.7A800000 
00000000. 7AFCFFFF 


KESU KESU M-U- 0 
KESU KESU M-U- 0 
KESU KESU M-U- 0 
KESU KESU MLK- 0 
KESU KE-- MLK- 0 


00000000.7FFF2000 
00000000. 7FFFFFFF 


Read Writ Bits GH 


PROCESS 


PROCESS 


PROCESS 
PROCESS 


PROCESS 
PROCESS 
PROCESS 


PROCESS 
PROCESS 


PgTyp 


PTE 


ACTIVE 


ACTIVE 


ACTIVE 
ACTIVE 


PTE 
-to- 


PTE 
-to- 


PTE 
-to- 


ACTIVE 
ACTIVE 
ACTIVE 


ACTIVE 
ACTIVE 


PTE 
-to- 


FFFFFEFC.00100000 


FF000000.00000000 


FF000000.00000000 


FF000000.00000000 
FF000000.00000000 


FFFFFEFC.00100060 
FFFFFEFC.00101FF8 


FFFFFEFC.00102000 
FFFFFEFC.001E9FF8 


FFFFFEFC.001EA000 
FFFFFEFC.001EBF38 


FF000000.00000000 
FF000000.00000000 
FF000000.00000000 


FF000000.00000000 
FF000000.00000000 


FFFFFEFC.001FFFC8 
FFFFFEFC.001FFFF8 


0001 


0001 


0001 
0001 


0001 
0001 
0001 


0001 
0001 


RefCnt 


00000000 


00000000 


00000000 
00000000 


00000000 
00000000 
00000000 


00000000 
00000000 


Flink 


0000000D 


000000BC 


0000000E 
0000000F 


00000195 
0000011A 
00000190 


0000000C 
00000005 


PTE Address PTE 


Mapped Address 


FFFFFEFC.00000000 
FFFFFEFC.00002000 


FFFFFEFD.BF000000 00003784.40101309 
FFFFFEFD.BF000008 000038DC.40101309 


Beohecsu 126 null pages: VA 
-to- 
FFFFFEFC.00100000 FFFFFEFD.BF000400 000037DB.40101309 VALID 
Seeeessz 116 null pages: VA 
-to- 
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00000000.80000000 
FFFFFEFB.FFFFFFFF 


Bits GH 


Read Writ 


FFFFFEFC.00004000 
FFFFFEFC.000FFFFF 


PgTyp 


Loc 


MLK- 0 PPT(L3) ACTIVE 
MLK- 0 PPT(L3) ACTIVE 


PTE 
-to- 


KE-- K--- MLK- 0 PPT(L3) ACTIVE 


FFFFFEFC.00102000 
FFFFFEFC.001E9FFF 


PTE 
-to- 


FFFFFEFC.00200000 
FFFFFEFD.BEFFFFF8 


Bak 


RefCnt 


Flink 


FF000000.00000000 0001 000000F3 
FF000000.00000000 0001 00000006 


FFFFFEFD.BF000010 
FFFFFEFD.BF0003F8 


FF000000.00000000 0001 00000004 


FFFFFEFD.BF000408 
FFFFFEFD.BF0007A0 


Blink 


0000001F 
000001B4 


0000009F 


continued 


VM-0758A-Al 


FFFFFEFC.001EA000 
FFFFFEFC.001EC000 
FFFFFEFC.001EE000 
FFFFFEFC.001F0000 


FFFFFEFC.001FE000 


FFFFFEFD.BF0007A8 00003758.40101309 VALID KE-- K--- MLK- 0 PPT(L3) ACTIVE 

FFFFFEFD.BF0007B0 00003755.40101309 VALID KE-- K--- MLK- 0 PPT(L3) ACTIVE 

FFFFFEFD.BF0007B8 00003785.40101309 VALID KE-- K--- MLK- 0 PPT(L3) ACTIVE 

FFFFFEFD.BF0007C0 0000387B.40101309 VALID KE-- K--- MLK- 0 PPT(L3) ACTIVE 
6 null pages: VA FFFFFEFC.001F2000 PTE 

-to- FFFFFEFC.001FDFFF -to- 

FFFFFEFD.BF0007F8 00004FAD.40001309 VALID KE-- K--- -LK- 0 PPT(L3) ACTIVE 
768 null pages: VA FFFFFEFC.00200000 PTE 

-to- FFFFFEFC.007FFFFF -to- 
914432 entries not in memory: VA FFFFFEFC.00800000 PTE 

-to- FFFFFEFD.BEFFFFFF -to- 

FFFFFEFD.BF000000 FFFFFEFD.BF6FC000 00004FAE.40001109 VALID K--- K--- -LK- 0 PPT(L2) ACTIVE 
893 null pages: VA FFFFFEFD.BF002000 PTE 

-to- FFFFFEFD.BF6FBFFF -to- 


FFFFFEFD.BF6FC000 FFFFFEFD.BF6FDBFO 00004F65.40000109 VALID 


K--- NONE -LK- 0 PPT(L1) ACTIVE 


Process index: 0013 Name: ACME SERVER Extended PID: 00000413 

ASB Address: 7B02E000 

LTP_POOL: 7B030800 IMPURE: 7FFDO0C4 

BLN: 00002600 9728. 

BID: 00000032 50. 

FP: 7FFA5118 7FFD00C4 

SP: 7FFA5118 7FFD00C4 

FLAGS: 00000000 

PERSONA_ID: 2 

SAVED_ID: 1 

I0_OPERATION/OLD_FAB: 00000000 

P4_PARM: 00000880 

STS: 00018292 

EFN: 0000001D 

STALL_STRUCT: 00000000 

ERRAST: 00000000 

SUCAST: 00000000 

FAB: 7FFD1000 

STACK 7B02F200 

STKTOP: 7B02E070 

STKBO! 7B02F200 

STKLEN: 00001190 4496. 

MODE_OFFSET: 00000001 Lie 

SAVED_ASB: 00000000 

BKP: 00002008 ASY_THREAD,STALL_WITH_PERSONA 

BDB Address: 7B028710 

FLINK 7B02726C BID: oc 12. 

BLINK 7B02726C BLN: 1c 28. 

FLGS 00 

USERS: 0000 0. BLB_PTR: 00000000 

CACHE_VAL:00 0. BUFF_ID: 0000 0. 

SIZE: 00000000 NUMB: 0000003B 

ADDR: 00000000 VBN: 00000000 

VBNSEQNO: 00000000 WAIT: 00000000 

WK1: 00000000 CURBUFADR: 00000000000FC000 

REL_VBN: 00000000 PRE_CCTL: 00 

ASB: 00000000 

ALLOC_ADDR: 00000000 BI_BDB: 00000000 

ALLOC_SIZE: 0000 0 AI_BDB: 00000000 

VAL_VBNS: 00000000 POST_CCTL:00 

IOSB: 00000000 WAIT_Q FLINK: 00000000 
00000000 WAIT_Q BLINK: 00000000 

REUSE_COUNT: 00000000 IDX_BKT_LEVEL: 00 


FF000000. 
FF000000. 
FF000000. 
FF000000. 


FFFFFEFD. 
FFFFFEFD. 


FF000000. 


FFFFFEFD. 


FFFFFEFD. 


FFFFFEFD. 
-BF6FBFF8 


FFFFFEFD 


FF000000. 


FFFFFEFD. 
FFFFFEFD. 


00000000. 


SDA Commands 
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00000000 
00000000 
00000000 
00000000 


0001 
0001 
0001 
0001 


0000000B 
00000024 
0000005F 
00000015 


00000011 
OOO000A1 
00000022 
000000E5 


BFO007C8 
BFOO00O7FO 


00000000 0001 O000000E 00000003 


BF000800 
BFOOLFF8 


BF002000 


00000000 0001 00000008 00000002 


BF6FCO008 
BF6FDBE8 


83F62000 0001 00000001 00000001 


continued 
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SDA Commands 
SHOW PROCESS 


Process index: 0013 Name: ACME SERVER Extended PID: 00000413 
Process active channels 

Channel CCB Window Status Device/file accessed 
0010 7FEB8000 00000000 WFGLX0$DKB500: 
0020 7FEB8020 81AFEFCO WFGLX0$DKB500: [ VMS$COMMON.SYSEXE 
0030 7FEB8040 81756700 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0040 7FEB8060 81753E80 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0050 7FEB8080 81753E00 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0060 7FEB80A0 81755600 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0070 7FEB80CO 81756B00 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0080 7FEB80EO 81756680 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0090 7FEB8100 8175D3C0 WFGLX0$DKB500: [ VMS$COMMON.SYSMSG 
Q00OAO 7FEB8120 8175CBO00 WFGLX0$DKB500: [ VMS$COMMON.SYSMSG 
00BO 7FEB8140 00000000 Busy MBA16: 
00CO 7FEB8160 81B01B80 WFGLX0$DKB500: 
00DO0 7FEB8180 81B02140 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
Q0OEO 7FEB81A0 81755340 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
QOFO 7FEB81CO 817534C0 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0100 7FEB81E0 81753CC0 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0110 7FEB8200 817557C0 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0120 7FEB8220 817572C0 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0130 7FEB8240 81756ECO WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
0140 7FEB8260 817559C0 WFGLX0$DKB500: [ VMS$COMMON.SYSLIB 
Total number of open channels 20. 

Process index: 0013 Name: ACME SERVER Extended PID: 00000413 


Process activated images 


ACME_SERVER.EXE;1 
PTHREADSRTL.EXE;1 (section file) 
LIBOTS.EXE;1 (section file) 
LIBRTL.EXE;1 (section file) 
CMA$TIS_SHR.EXE;1 (section file) 
DECC$SHR.EXE;1 (section file) 
DPML$SHR.EXE;1 (section file) 
SHRIMGMSG.EXE;1 (section file) 
DECC$MSG.EXE;1 (section file) 


SYS50.SYSMGR ]ACMES$SERVER. LOG; 30 


VMSS$VMS_ACMESHR.EXE; 1 
SECURESHR.EXE;1 (section file) 
SECURESHRP.EXE;1 (section file) 
PTD$SERVICES_SHR.EXE;1 (section file) 
CRFSHR.EXE;1 (section file) 
ADARTL.EXE;1 (section file) 
CMASRTL.EXE;1 (section file) 
TRACE.EXE;1 (section file) 


Image Name/Link Time/Section Type Start End Type IMCB Sym Vect Maj,Minor ID Base End ImageOff 
ACME_SERVER 00010000 000705FF MAIN 7FE98060 113,12385697 
3-FEB-2001 22:56:22.00 
SHRIMGMSG 000B4000 O00BA9FF MRGD SHR 7FE99840 000B4000 113,12524133 
3-FEB-2001 23:11:29.25 
DECCS$MSG 000BCO00 O00BFFFF MRGD SHR 7FE98A30 000BC0O00 113,12609585 
3-FEB-2001 23:20:49.27 
VMS$VMS_ACMESHR 00108000 00389FFF MRGD 7FE992A0 0012DE80 113,12563930 
3-FEB-2001 23:15:50.06 
SECURESHRP 7B2B4000 7B335FFF GLBL PRT SHR 7FE99A20 7B2B9640 1,4 
3-FEB-2001 22:42:02.12 
System Resident Code 80800000 808271FF 00030000 
Shareable Address Data 7B2B4000 7B2B9FFF 00000000 
Read-Write Data 7B2C4000 7B2C59FF 00010000 
Shareable Read-Only Data 7B2D4000 7B2D47FF 00020000 
Shareable Address Data 7B314000 7B314717 00060000 
Demand Zero Data 7B324000 7B3241FF 00070000 
Compressed Data 7B334000 7B334BFF 00080000 
ADARTL 70030000 7CO7BFFF GLBL SHR 7FE98B50 7C037320 17.3 
3-FEB-2001 22:50:26.28 
Shareable Address Data 70030000 7C0385FF 00000000 
Shareable Address Data 7C03A000 7CO3D5FF 00010000 
Shareable Code 7C03E000 7CO709FF 00020000 
Read-Write Data 7C072000 7C0727FF 00060000 
Shareable Read-Only Data 7C074000 7C0745FF 00070000 
Read-Write Data 7C076000 7C0761FF 00080000 
Demand Zero Data 70078000 7C0781FF 00090000 
Compressed Data 7C07A000 7CO7AFFF 000A0000 
SYS$PUBLIC_VECTORS 81003E78 81005E37 GLBL 7FE98840 81003E78 113,12237208 
SYSSBASE_IMAGE 81019D90 8102C23F GLBL 7FE98720 81019D90 113,12239366 
Total images = 19 Pages allocated = 885 
continued 
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Process index: 0013 Name: ACME SERVER Extended PID: 00000413 


No buffer objects for this process 


Process inde 0013 Name: ACME SERVER 


The fandle vector is empty. 


Process index: 0013 Name: ACME SERVER Extended PID: 00000413 


PROCESS PERSONAE 


ID PSB 


PERMANENT 


Username 


0001 815C8F00 005 SYSTEM 


Persona ID: 0001 Username: SYSTEM 


Flags : 00000001 Refcount : 005 
Mode : User Noaudit : 1 
Account: <start> UIC [00001,000004] 
Privileges: 
Authorized : 000000208009D025 
Permanent : 000000208009D025 
Working (Persona): 00000060D009D025 
Working (Image) : 0000000000000000 
Enabled rights: 0000000000000003 ( PERSONA,SYSTEM ) 


Rights Chain: PERSONA (Enabled) : 


00010004 


00000001 


Rights Chain: SYSTEM (Enabled) : 


ID 


80010001 


00000000 


Process index: 0013 Name: ACME SERVER Extended PID: 00000413 


NPOOL address: (None) 
Pool map address: (None) 
Number of lookaside lists: 0 
Granularity size: 16 
Pl pool available for image requests: FFFFFD30 
Pl pool allowed for image requests: 00004600 
Variable list header: 00000000. 7FFF0188 
Segment(s) 
Start End Length 
7FE96000 7FEBSFFF 00020000 
Dump of packets allocated from P1 Pool 
Start Length 
7FE96000 00000080 
7FE96080 00000080 
7FE96100 00000060 
KFERES TFE9A5FO 000000E0 
FREE_IMCB 7FE9A6D0 00000120 
KFERES TFE9A7FO 000000E0 


SDA Commands 
SHOW PROCESS 


Header contents 


00000000 00400080 7FE96FD8 00000000 .... o@...ee 
00000000 00400080 7FE96F7C 00000000 .... 
00000000 00400060 7FE97044 00000000 .... 


00000008 026600E0 00000000 B7CE07D0 
00000203 07660118 7FE99CDO 7FFD0698 
00000008 026600E0 00000000 B7CD9220 


continued 
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SDA Commands 4-197 


SDA Commands 
SHOW PROCESS 


Summary of Pl Pool contents 


FREE_IMCB 


MISC 
RDE 


LNMC 
LNMC 


Total space used: 000048D0 (1 
in 00000053 (83.) packets 
Total space utilization: 14.2 


Process index: 0013 


Name: ACME SERVER 


Packet count 
00000001 
00000001 
0000000A 


00000026 
0000000D 
00000013 
00000006 


00000001 
00000001 


00000020 
00000020 


8640.) bytes out 


% 


Extended PID: 


Packet bytes Percent 
00000080 (0.7%) 
00000810 (11.18) 
000008c0 (12.0%) 
00002740 (53.9%) 

00000B20 (15.3%) 
00001560 (29.4%) 
000006CO (9.3%) 
00000040 (0.3%) 
00000040 (0.3%) 
00001000 (22.0%) 
00001000 (22.0%) 


of 00020000 (131072.) bytes 


00000413 


Process has no TQES 


VM-0809A-Al 


The SHOW PROCESS/ALL command displays information taken from the PCB 
and KTBs of process ACME_SERVER, then displays the process registers, inner 
mode semaphores, the process header and working set, the process section 
table, process regions, the page tables of the process, RMS data structures, 
information about I/O channels owned by the process, images activated by 

the process, process persona data structures, and process pool. You can also 
obtain these displays using the /PCB, /THREADS, /REGISTERS, /SEMAPHORE, 
/PHD, /WORKING_SET_LIST, /PST, /RDE, /PAGE=ALL, /RMS, /CHANNELS, 
/IMAGES=ALL, PERSONA/RIGHTS, and /POOL/HEADER/RING_BUFFER 
qualifiers, respectively. This process had no locks, buffer objects, fast I/O handles, 
or TQEs to be displayed. 


3. SDA> SHOW PROCESS/PAGE_TABLES/ADDRESS=805E7980 


PO page table 


MAPPED ADDRESS 


00000000.00010000 FFFFFFFC.00000040 000003E7 


00000000.00020000 FFFFFFFC.00000080 0000046E 


00000000.00030000 FFFFFFFC.000000C0 0000015C 


00000000.00040000 FFFFFFFC.00000100 0000014D 


PTE ADDRESS 


8 null pages: 


7 null pages: 


7 null pages: 


7 null pages: 


991 null pages: 


130048 entries not in 


PTE 


VA  00000000.00000000 
-to- 00000000.0000E000 


-00160F09 VALID KESU NONE M-U- 


VA  00000000.00012000 
-to- 00000000.0001E000 


-0016FF09 VALID KESU KESU M-U- 


VA  00000000.00022000 
-to- 00000000.0002E000 


-00060F01 VALID KESU NONE --U- 


VA  00000000.00032000 
-to- 00000000.0003E000 


-00163F09 VALID KESU KE-- M-U- 
VA  00000000.00042000 
-to- 00000000.007FE000 


00000000.00800000 
00000000.3FFFE000 


memory: VA 
=to= 


TYPE READ WRIT BITS GH PGTYP LOC 


PTE 
-to- 


0 PROCESS ACTIVE 


PTE 
-to- 


0 PROCESS ACTIVE 


PTE 
-to- 


0 PROCESS ACTIVE 


PTE 
-to- 


0 PROCESS ACTIVE 


PTE 
-to- 


PTE 
-to- 


This example displays the page tables of a process 


805E7 


4-198 SDA Commands 


980. 


FFFFFFFC. 
FFFFFFFC. 


03000000 


FFFFFFFC. 
FFFFFFFC. 


03000000. 


FFFFFFFC. 
FFFFFFFC. 


00000002 


FFFFFFFC. 
FFFFFFFC. 


03000000 


FFFFFFFC. 
FFFFFFFC. 


FFFFFFFC. 
FFFFFFFC. 


00000000 
00000038 


-00000000 


00000048 
00000078 


00000000 


00000088 
000000B8 


- 00090000 


000000c8 
000000F8 


-00000000 


00000108 
00001FF8 


00002000 
OOOFFFF8 


REFCNT FLINK BLINK 


0001 00000000 00000034 


0001 00000000 00000037 


0001 00000000 00000036 


0001 00000000 00000032 


ZK-8864A-GE 


whose PCB address is 


4, SDA> SHOW PROCESS/BUFFER_OBJECTS/FANDLES 


Process index: 0022 Extended PID: 00000062 


Name: NODEA_RTA1: 


REFCNT 


PID 


PAGCNT 


BASE 


SDA Commands 
SHOW PROCESS 


FFFFFFFF.7DE68000 S2 WINDOW 
FFFFFFFF .7DE66000 $2 WINDOW 
FFFFFFFF.FFFFFFFF NOSVA 
FFFFFFFF.7DE64000 S2_ WINDOW 
FFFFFFFF.FFFFFFFF NOSVA 
FFFFFFFF.7DE62000 S2 WINDOW 
FFFFFFFF.FFFFFFFF NOSVA 
FFFFFFFF.8120C000 NOQUOTA 


8151AE00 
814A6CC0 
814FBA00 
81512200 
8151A8C0 
81438580 
81464480 
81416F00 


Address 


User 
Kernel 


00000011 
00000012 
00000013 
00000014 
00000015 
00000016 
00000017 
00000018 


00000031 
00000009 
00000009 
00000009 
00000009 
00000009 
00000009 
00000001 


00010022 
00010022 
00010022 
00010022 
00010022 
00010022 
00010022 
00010022 


Fandle Vector Header 


00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 


00000043 00000880 00000018.81416F00 


TFF 68290 


Address 


IRP 


fastio_done Orgfun 


Fandles 


Data bo handle 


00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
FFFFFEFB. 
FFFFFEFB. 
00000000. 


00084000 
80000000 
80000000 
80028000 
80028000 
FF800000 
FF800000 
7TFF76000 


IOSA bo handle 


DBYLEN 


815CEF40 set 
815CE4C0 set 
815CE200 set 
815D4B80 set 
815D65C0 set 
815D6880 set 


7FF682B0 
7FF682D0 
TFF682F0 
TFF 68310 
TFF68330 
TFF68350 


7FF68810 
TFF68830 


7FF68AB0 
7FF68AD0 
TFF68AF 0 


815D6B40 set 
815D5880 set 


815D9840 set 
815CD040 set 
815CB480 set 
The SHOW PROCESS/BUFFER_OBJECTS/FANDLES command displays all the 
buffered objects and fast I/O handles that a process has created. 


00020031 
00020030 
00000031 
00000030 
00020031 
00020030 


00020031 
00020030 


00000013 


00020031 
00020030 
00000031 


00000016. 
00000016. 
00000016. 
00000016. 
00000015. 
00000015. 


81438580 
81438580 
81438580 
81438580 
8151A8C0 
8151A8C0 


00000013.814FBA00 00000011. 
00000013.814FBA00 00000011. 


free FVEs (IRP = 00000000) 


00000017.81464480 00000011. 
00000017.81464480 00000011. 
00000017.81464480 00000011. 


00000011. 
00000011. 
00000011. 
00000011. 
00000011. 
00000011. 


8151AE00 00000000. 
8151AE00 00000000. 
8151AE00 00000000. 
8151AE00 00000000. 
8151AE00 00000000. 
8151AE00 00000000. 


8151AE00 00000000. 
8151AE00 00000000. 


VA 
-to- 


8151AE00 00000000 
8151AE00 00000000 
8151AE00 00000000 


00002000 
00002000 
00002000 
00002000 
00002000 
00002000 


00002000 
00002000 


7FF68850 
TFF68A90 


-00002000 
-00002000 
-00002000) 


SDA Commands 4-199 


SDA Commands 
SHOW PROCESS 


5. SDA> SHOW PROCESS JOB_CONTROL/TQE 
Process index: 000C Name: JOB CONTROL Extended PID: 0000004C 


TQE 
address Expiration Time Type 


81504080 OQ0AO5ABD.895F93C5 27-NOV-2001 11:17:17.37 TSD--- 
815026C0 Q0A05AC3.80D0E000 27-NOV-2001 12:00:00.00 TSA--- 
81502180 0Q0A0C160.635594EF 7-APR-2002 02:00:00.12 TSA--- 


This example shows the timer queue entries for the process JOB_CONTROL. See 
Table 4-31 for an explanation of the Type codes. 


6. SDA> SHOW PROCESS /IMAGE 
Process index: 0005 Name: SA_STARTUP_DCL Extended PID: 00000025 


Image Name Type IMCB GP 
SDA MAIN TFE86EB0 00000000.00230000 
SDASSHARE GLBL 7FE86190 00000000.00636000 
SMGSHR GLBL 7FE87830 00000000.00706000 
Total images = 17 Pages allocated = 2165 


SDA> show process/image=sda 


Process index: 0005 Name: SA_STARTUP_DCL Extended PID: 00000025 


Image Name/Link Time/Section Type Type/File Id IMCB Sym Vect Maj,Min ID,Match 
ttt rrr rrr rrr nn nnn nnn nsnn sccm scrsccnn cocccsss socsscrn cocccscccncce nee *** see below *** 


SDA MAIN 7FE86EBO 231F,85F10A8C,01 
17-MAY-2004 10:55:33.89 (1346,1,0) 
Code 
Data (read only) 
Short data 
Fixup 


*** Rightmost columns from above output moved here *** 


Base End ImageOff 


GP = 00000000.00230000 


00000000.00010000 00000000.0001022F 00010000 
00000000.00020000 00000000.000200EF 00020000 
00000000.00030000 00000000.00030077 00030000 
00000000.80000000 00000000.800003FF 80000000 


This example includes the GP (global pointer). 


4-200 SDA Commands 


SDA Commands 
SHOW RAD 


SHOW RAD 


Format 


Parameter 


Qualifier 


Examples 


Displays the settings and explanations of the RAD_SUPPORT system parameter 
fields, and the assignment of CPUs and memory to the Resource Affinity Domains 
(RADs). This command is only useful on platforms that support RADs. By 
default, the SHOW RAD command displays the settings of the RAD_SUPPORT 
system parameter fields. 


SHOW RAD [number !/ALL] 


number 
Information on CPUs and memory for the specified RAD. 


/ALL 
Displays settings of the RAD_SUPPORT parameter fields and the CPU and 
memory assignments for all RADs. 


1. SDA> SHOW RAD 


Resource Affinity Domains 


RAD information header address: FFFFFFFF.81032340 


Maximum RAD count: 00000008 

RAD containing SYS$BASE IMAGE: 00000000 

RAD support flags: 0000004F 

3 22 11 

1 4 Bg 6 te 8 td 0 

+-----------+-----------+-----------+----------- + 

|.-|. “| skip| 95] lp. -[. [ee]. ‘[-elés|ezlae| 

tcssecescecatueecenmuccatcencdeacose bo aeneeeneee 

|..|-.| | 0| o| | a -[.-[--[- “| -1100) 31133] 

Le wiiecnissen dt neawewewaate aan ana aacet Guneueee nea 

Bit 0 = 1: RAD support is enabled 

Bit 1 =1: Soft RAD affinity support is enabled 
(Default scheduler skip count of 16 attempts) 

Bit 2 = 1: System-space replication support is enabled 

Bit 3 = 1: Copy on soft fault is enabled 

Bit 4 = 0: Default RAD-based page allocation in use 
Allocation Type RAD choice 
Process-private pagefault Home 
Process creation or inswap Random 
Global pagefault Random 


System-space page allocation Current 


Bit 5 = 0: RAD debug feature is disabled 


SDA Commands 4-201 


SDA Commands 


SHOW RAD 
Bit 6 = 1: Per-RAD non-paged pool is enabled 
This example shows the settings of the RAD_SUPPORT system parameter 
fields. 


2. SDA> SHOW RAD 2 


Resource Affinity Domain 0002 


CPU sets: 
Active 08 10 11 
Active 08 10 11 


Configure 08 09 10 11 
Potential 08 10 11 


PFN ranges: 
Start PFN End PFN PFN count Flags 


01000000 0107FFE7 0007FFE8 000A OpenVMS Base 
0107FFE8 0107FFFF 00000018 0009 Console Base 


SYSPTBR: 01002A01 
RAD data: B817C000 


This example shows information on the CPUs and memory for RAD 2. 


4-202 SDA Commands 


SDA Commands 
SHOW RESOURCES 


SHOW RESOURCES 


Format 


Parameters 


Qualifiers 


Displays information about all resources in the system or about a resource 
associated with a specific lock. 


SHOW RESOURCES {/ADDRESS=n1/ALL (d) 
| /BRIEF|/CACHEDI/CONTENTION [=ALL] 
| /LOCKID=/ock-id |/LIST |/NAME=name 
|/OWNED |/STATUS= (keyword [,keyword...])} 


None. 


/ADDRESS=n 
Displays information from the resource block at the specified address. 


/ALL 
Displays information from all resource blocks (RSBs) in the system. This is the 
default behavior of the SHOW RESOURCES command. 


/BRIEF 
Displays a single line of information for each resource. 


/CACHED 
Displays resource blocks that are no longer valid. The memory for these resources 
is saved so that later requests for resources can use them. 


/CONTENTION [=ALL] 

Displays only resources that have at least one lock on either the waiting or 
conversion queue. Unless you specify the ALL keyword, resources with locks on 
the waiting or conversion queues that are not participating in deadlock searches 
are ignored. (Locks not participating in deadlock searches are requested with 
either the LCK$M_NODLCKWT or LCK$M_NODLCKBLK flags.) 


/LIST 
Displays summary information for each resource, followed by a list of all locks 
associated with the resource. 


/LOCKID=lock-id 
Displays information on the resource associated with the lock with the specified 
lock-id. 


/NAME=name 

Displays information about the specific resource. Name may be the actual name 
of the resource, if it only contains uppercase letters, numerals, the underscore 
(_), dollar sign, colon (:), and some other printable characters, as for example, 
/NAME=MY_LOCK. If it contains other printable characters (including lowercase 
letters), you may need to enclose the name in quotation marks (""), as for 
example, /NAME="My_Lock/47". If it contains nonprintable characters, the name 
may be specified as a comma-separated list comprised of strings and hexadecimal 
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numbers, as for example, /NAME=("My_Lock",0C00,'"/47") would specify the name 
"My_Lock<NUL><FF>/47". The hexadecimal number can be no more than 8 
digits (4 bytes) in length. Nonprintable sequences or more than 4 bytes must 

be split into multiple hexadecimal numbers. The maximum length of a resource 
name is 32 characters. 


/OWNED 
Displays only owned resources. 


/STATUS=(keyword [,keyword...]) 
Displays only resources that have the specified status bits set in the RSB$L_ 


Description 


STATUS field. Status keywords are as follows: 


Keyword Meaning 

2PC_IP Indicates a two-phase convert operation in progress 
BRL Indicates byte range resource 

CHK_BTR Checks for better master 

CVTFULRNG Indicates full-range requests in convert queue 
CVTSUBRNG Indicates sub-range requests in convert queue 
DIRENTRY Indicates directory entry during failover 
DIR_IP Creates directory entry 

DIR_RQD Indicates directory entry required 

INVPEND Checks for value block invalidation 
RBLD_ACT Indicates lock rebuild active for this tree 
RBLD_IP Indicates rebuild operation in progress 
RBLD_RQD Indicates rebuild required for this resource tree 
RM_ACCEPT Accepts new master 

RM_DEFLECT Deflects remote interest 

RM_IP Indicates resource remaster in progress 
RM_PEND Indicates a pending resource remaster operation 
RM_RBLD Indicates to always rebuild resource tree 
RM_WAIT Blocks local activity 

VALCUR Indicates value block is current 

VALINVLD Indicates value block invalid 

WTFULRNG Indicates full-range requests in wait queue 
WTSUBRNG Indicates a sub-range requests in wait queue 


The SHOW RESOURCES command displays the information listed in Table 4-25 
either for each resource in the system or for the specific resource associated with 


the specified lock-id, address, or name. 
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Table 4-25 Resource Information in the SHOW RESOURCES Display 


Field (in order of display) 


Contents 


RSB 


GGMODE 


Status 
Parent RSB 


CGMODE 


Sub-RSB count 
FGMODE 
Lock Count 
RQSEQNM 
BLKAST count 
CSID 


Resource 


Valblk 


Length 
x mode 


Address of the resource block (RSB) that describes 
this resource. 


Indication of the most restrictive mode in which a 
lock on this resource has been granted. Table 4—26 
shows the values and their meanings. 

For information on conflicting and incompatible 
lock modes, see the HP OpenVMS System Services 
Reference Manual. 


The contents of the resource block status field. 


Address of the RSB that is the parent of this RSB. 
This field is 00000000 if the RSB itself is a parent 
block. 


Indication of the most restrictive lock mode to which 
a lock on this resource is waiting to be converted. 
This does not include the mode for which the lock 
at the head of the conversion queue is waiting. See 
Table 4-26. 


Number of RSBs of which this RSB is the parent. 
This field is 0 if the RSB has no sub-RSBs. 


Indication of the full-range grant mode. See 
Table 4-26. 


The total count of all locks on the resource. 
Sequence number of the request. 


Number of locks on this resource that have 
requested a blocking AST. 


Cluster system identification number (CSID) and 
name of the node that owns the resource. 


Dump of the name of this resource, as stored at 
the end of the RSB. The first two columns are the 
hexadecimal representation of the name, with the 
least significant byte represented by the rightmost 
two digits in the rightmost column. The third 
column contains the ASCII representation of the 
name, the least significant byte being represented 
by the leftmost character in the column. Periods 
in this column represent values that correspond to 
nonprinting ASCII characters. 


Valblk hexadecimal and ASCII dump of the first 
16 bytes of the value block associated with this 
resource. See Extended Value Block later in this 
table for the display of the rest of the value block. 


Length in bytes of the resource name. 


Processor mode of the namespace in which this RSB 
resides (Group, Kernel, User). 


(continued on next page) 
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Table 4—25 (Cont.) Resource Information in the SHOW RESOURCES Display 


Field (in order of display) 


Contents 


owner 


Seqnum 


Extended Valblk 


Granted queue 


Conversion queue 


Waiting queue 


Owner of the resource. Certain resources, owned by 
the operating system, list “System” as the owner. 
Locks owned by a group have the number (in octal) 
of the owning group in this field. 


Sequence number associated with the resource’s 
value block. If the number indicates that the value 
block is not valid, the words “Not valid” appear to 
the right of the number. 


If any of the last 48 bytes of the value block (see 
Valblk earlier in this table) are non-zero, then 

the entire 64-byte value block is displayed as 
hexadecimal and ASCII dumps. Otherwise this 
display is omitted. The display appears only when 
value block contents are non-zero, without regard to 
the state of the RSB$M_XVAL_VALID flag. 


List of locks on this resource that have been 
granted. For each lock in the list, SDA displays 
the number of the lock and the lock mode in which 
the lock was granted. 


List of locks waiting to be converted from one mode 
to another. For each lock in the list, SDA displays 
the number of the lock, the mode in which the lock 
was granted, and the mode to which the lock is to 
be converted. 


List of locks waiting to be granted. For each lock in 
the list, SDA displays the number of the lock and 
the mode requested for that lock. 


Table 4-26 Lock Modes on Resources 


Value’ Meaning 

NL Null mode 

CR Concurrent-read mode 
CW Concurrent-write mode 
PR Protected-read mode 
PW Protected-write mode 
EX Exclusive mode 


lValues are shown in order from the least restrictive mode to the most restrictive. 
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SDA> SHOW RESOURCES 
Resource Database 
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RSB: FFFFFFFF.7FEECE40 GGMODE: PW Status: VALID XVALID 

Parent RSB: 00000000.00000000 CGMODE: PW 

Sub-RSB count: 0 FGMODE: PW 

Lock Count: 1 RQSEQNM: 0000 

BLKAST count: 0 CSID: 00000000 (SAND41) 

Resource: 00000000 0043524A OJRC..... Valblk: 5F73695F 73696854 
Length 3 00000000 00000000 ........ 6F5F7473 65745F61 
User mode 00000000 00000000 ........ This is a_test_o 
Group 001 00000000 00000000 ........ Seqnum: 00000001 

Extended Valblk: 6F5F7473 65745F61 5F73695F 73696854 This is a test o 


565F6465 
00000000 


646E6574 78455F65 68745F66 
00006B63 6F6C425F 65756C61 
00000000 00000000 00000000 00000000 


Granted queue (Lock ID / Gr mode / Range): 
1500082F PW 00000000-FFFFFFFF 


f the Extended V 
alue Block...... 


Conversion queue (Lock ID / Gr mode / Range -> Rq mode / Range): 


*k* EMPTY QUEUE *** 


Waiting queue (Lock ID / Rq mode / Range): 
**kk EMPTY QUEUE *** 


SDA> SHOW RESOURCES 
Resource Database 


RSB: FFFFFFFF.7FEECE40 GGMODE: PW Status: VALID 

Parent RSB: 00000000.00000000 CGMODE: PW 

Sub-RSB count: 0 FGMODE: PW 

Lock Count: 1 RQSEQNM: 0002 

BLKAST count: 0 CSID: 00000000 (SAND41) 

Resource: 00000000 0043524A OJRC..... Valblk: 5F74726F 68735F41 
Length 3 00000000 00000000 ........ 00000000 00656E6F 
User mode 00000000 00000000 ........ A short one..... 
Group 001 00000000 00000000 ........ Seqnum: 00000003 

Extended Valblk: 00000000 O0656E6F 5F74726F 68735F41 A short one..... 

565F6465 6466574 78455F65 68745F66 f the Extended_V 


00000000 00006B63 6F6C425F 65756C61 


00000000 00000000 00000000 00000000 


Granted queue (Lock ID / Gr mode / Range): 
3900080C PW 00000000-FFFFFFFF 


Conversion queue (Lock ID / Gr mode / Range -> Rq mode 
*** EMPTY QUEUE *** 


Waiting queue (Lock ID / Rq mode / Range): 
**kk EMPTY QUEUE *** 


alue Block...... 


/ Range): 


These examples for Alpha and 164 systems show two cases: 


— output from a program writing a longer block 


— output where the last writer wrote a short value block (XVALID not set), but 
because a previous writer wrote non-zero data to the high portion of the block 
and these data are still present, the data in the Extended Value Block are 


shown. 
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2.SDA> SHOW RESOURCE/CONTENTION 


Resource Contention Information: 


RSB Address Parent RSB Addr Resource Name 


FFFFFFFF.7FB39050 FFFFFFFF.7FB47A50 P.. 


FFFFFFFF.7FD36450 FFFFFFFF.7FD0EC50 QMANS$JBC_ALIVE_01 


searches. 
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LKB Address 


FFFFFFFF .7FAEC350 
FFFFFFFF .7FB34550 
FFFFFFFF .7FA93250 
FFFFFFFF .7FB3EA50 
FFFFFFFF.7FAE7B50 
FFFFFFFF .7FA36050 
FFFFFFFF.7FA7BE50 
FFFFFFFF.7FAAC650 
FFFFFFFF .7FA62C50 
FFFFFFFF.7FAF9950 
FFFFFFFF .7FA33C50 
FFFFFFFF.7FB14550 


FFFFFFFF .7FB3CC50 
FFFFFFFF.7FACOE50 
FFFFFFFF.7FA74950 
FFFFFFFF.7FA4C050 
FFFFFFFF.7FAC5050 
FFFFFFFF .7FB38450 
FFFFFFFF.7FACD450 
FFFFFFFF.7FAD2250 
FFFFFFFF.7FAE0750 
FFFFFFFF.7FB37B50 
FFFFFFFF.7FB14A50 
FFFFFFFF.7FAD4950 
FFFFFFFF.7FAC9550 
FFFFFFFF .7FB03250 
FFFFFFFF.7FD70C50 


FFFFFFFF.7FDC5650 
FFFFFFFF.7FDF4950 


FFFFFFFF.7FD07550 
FFFFFFFF.7FDF4A50 


FFFFFFFF.7FD27050 
FFFFFFFF.7FD7B450 


00010027 
00000000 
00000000 
00000000 
00000000 
00010023 
00000000 
00000000 
00010028 
00010024 
00000000 
00000000 


00010024 
00010023 
00000000 
00010026 
00010022 
00010025 
00010028 
00000000 
00000000 
00000000 
00010027 
00000000 
00000000 
00000000 
00000000 


00010026 
00010020 


00010024 
00010020 


00000000 
00000000 


Node 


SWORKS 
CMOS 
CMOS 
CMOS 
CMOS 
SWORKS 
CMOS 
SWORKS 
SWORKS 
SWORKS 
CMOS 
CMOS 


SWORKS 
SWORKS 
CMOS 
SWORKS 
SWORKS 
SWORKS 
SWORKS 
CMOS 
CMOS 
SWORKS 
SWORKS 
CMOS 
CMOS 
CMOS 
CMOS 


SWORKS 
SWORKS 


SWORKS 
SWORKS 


CMOS 
CMOS 


Lockid 


04001158 
08000E46 
030015A3 
09000DCO 
080011C6 
060019F3 
020016A1 
010014aACc 
020017C1 
040010E5 
02001A36 
OFO0010E 


OBOOODDC 
03001400 
030016DE 
020018CE 
070013C3 
09000E0E 
0700134E 
080012DF 
0100120F 
01000E3D 
2500011c 
070012CA 
0900138D 
0C001069 
O80005AF 


1A00084C 
010009A1 


2E0004EB 
010009A2 


1A0002CA 
050007D4 


GR RQ Queue 


PW 
CR 
CR 
CR 
CR 
CR 
NL 
NL 
CR 
CR 


PW 
CR 
CR 
CR 
CR 
CR 
CR 
CR 
NL 
NL 
CR 
CR 
CR 
CR 
CR 


PW 


PW 


EX 


PW 
PW 
PW 
PW 


PR 
PR 
PR 
PR 
PR 


PW 


PW 


CR 


Granted 
Granted 
Granted 
Granted 
Granted 
Granted 
Granted 
Granted 
Convert 
Convert 
Waiting 
Waiting 


Granted 
Granted 
Granted 
Granted 
Granted 
Granted 
Granted 
Granted 
Granted 
Granted 
Convert 
Convert 
Convert 
Convert 
Convert 


Granted 
Waiting 


Granted 
Waiting 


Granted 
Waiting 


ZK-9159A-Al 


This example of the SHOW RESOURCES/CONTENTION command shows all the 
resources for which there is contention, and which are to be included in deadlock 
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3.SDA> SHOW RESOURCES/LIST 


Resource Database 


RSB Address Parent RSB Addr Resource Name LKB Address PID Node Lockid GR RQ Queue 


FFFFFFFE.DD058180 00000000.00000000 F11B$b$217$DKC200: otvi1l 
FFFFFFFE.DD04E580 00000000 MHERTZ 02000DDF CR Granted 


FFFFFFFE.DCF6F080 00000000.00000000 F11B$v$22$DKB12: QTvi1l 
FFFFFFFE.DD063180 00000000 MHERTZ 0200122D CR Granted 


FFFFFFFE.DCFAC680 00000000.00000000 SYS$_$70$DKA302: QoTv1l 
FFFFFFFE.DCF21180 00000000 MHERTZ 03001130 CR Granted 


FFFFFFFE.DCFBA580 FFFFFFFE.DCEFBC80 F11B$s.#.. BACH 
FFFFFFFE.DD032380 00000000 MHERTZ ODOOOC9F NL Granted 


FFFFFFFE.DD00E380 00000000.00000000 CACHEScmRAVEN_BACKUPU... MHERTZ 
FFFFFFFE.DCF54A80 00000000 B80VEN 03000280 PR Granted 
FFFFFFFE.DCEF8780 00000000 QTV9 12000C51 PR Granted 
FFFFFFFE.DD029880 00000000 KHERTZ 07000A6B PR Granted 
FFFFFFFE.DD002780 00000000 MHERTZ 16000829 PR Granted 


FFFFFFFE.DD060A80 00000000.00000000 SYS$_DSA71: QoTvil 
FFFFFFFE.DCF91580 00000000 MHERTZ 1A00115D CR Granted 


FFFFFFFE.DCF22B80 00000000.00000000 CACHE$cmB_PICCHUBCK Gene WHAMOO 


FFFFFFFE.DCF57E80 00000000.00000000 $DSA7779_$SEQCMD QTV9 
FFFFFFFE.DCF37D80 00000000 MHERTZ 0300011C PR Granted 


FFFFFFFE.DCFDD780 00000000.00000000 CACHE$cmPAGE_SWAP Ue: QTv11 
FFFFFFFE.DCFD3880 00000000 MHERTZ 0D00062A PR Granted 


FFFFFFFE.DCFA6480 00000000.00000000 vcc$v$1$DUA126: QTv1l 
FFFFFFFE.DD053980 00000000 MHERTZ 23000E09 PR Granted 


FFFFFFFE.DCF9BA80 00000000.00000000 $DSA7778_$WATCHR EBJB17 
FFFFFFFE.DCFFA280 00000000 MHERTZ 02000AF3 EX Waiting 
FFFFFFFE.DCF50380 00000000.00000000 F11B$aRAVEN_BACKUPG... KHERTZ 


FFFFFFFE.DCEED980 00000000 MHERTZ 01000025 PR Granted 


VM-0947A-Al 


This example shows the output from the SHOW RESOURCES/LIST command. 
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SHOW RMD 


Format 


Parameters 


Qualifiers 


Description 


Displays information contained in the reserved memory descriptors. Reserved 
memory is used within the system by memory-resident global sections. 


SHOW RMD [/QUALIFIERS] 


None. 


/ADDRESS=n 
Displays a specific reserved memory descriptor entry, given its address. 


/ALL 
Displays information in all the reserved memory descriptors. This qualifier is the 
default. 


The SHOW RMD command displays information that resides in the reserved 
memory descriptors. Table 4-27 shows the fields and their meanings. 


Table 4-27 RMD Fields 


Field Meaning 

Address Gives the address of the reserved memory descriptor. 

Name Gives the name of the reserved memory descriptor. 

Group Gives the UIC group that owns the reserved memory. This 
is given as -S- for system global reserved memory. 

RAD Gives the required RAD for the reserved memory. Displays 
"Any" if no RAD specified. 

PFN Gives starting page number of the reserved memory. 

Count Gives the number of pages reserved. 

In_Use Gives the number of pages in use. If an error occurred 

(Error) when the reserved memory was being allocated, the error 


condition code is displayed in parentheses. A second line, 
giving the text of the error, is also displayed in this case. 

Zero_PFN Gives the next page number to be zeroed. 

Flags Gives the settings of flags for specified reserved memory 
descriptor as a hexadecimal number, then displays key flag 
bits by name. The names may use multiple lines in the 
display. 
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Example 
SDA> SHOW RMD 
Reserved Memory Descriptor List 
In_Use 

Address Name Group RAD PFN Count (Error) Zero PFN Flags 
814199C0 LARGE 00022 Any 00000000 000004E2 00000000 00000000 000000E0 Group Page Tables 

GBLSec 
81419940 LARGE 00022 Any 00000000 00138800 (0000244C) 00000000 000001A0 Error Group GBLSec 

Error = %SYSTEM-F-INSFLPGS, insufficient Fluid Pages available 

81419ACO SMALL 00011 0001 00000180 00000001 00000000 00000180 000000E1 Alloc Group 

Page Tables GBLSec 
81419A40 SMALL 00011 0001 00000E00 00000080 00000000 00000E00 000000A1 Alloc Group GBLSec 


This example shows the default output of a SHOW RMD command. 
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SHOW RMS 


Format 


Parameters 


Qualifiers 


Description 


Examples 


Displays the RMS data structures selected by the SET RMS command to be 
included in the default display of the SHOW PROCESS/RMS command. 


SHOW RMS 


None. 


None. 


The SHOW RMS command lists the names of the data structures selected for the 
default display of the SHOW PROCESS/RMS command. 


For a description of the significance of the options listed in the SHOW RMS 
display, see the description of the SET RMS command and Table 4—2. 


For an illustration of the information displayed by the SHOW PROCESS/RMS 
command, see the examples included in the description of the SHOW PROCESS 
command. 


1. SDA> SHOW RMS 
RMS Display Options: IFB,IRB,IDX,BDB,BDBSUM,ASB,CCB,WCB,FCB,FAB,RAB,NAM, 
XAB,RLB,BLB, BLBSUM,GBD,GBH, FWA, GBDSUM, JFB, NWA, RU, DRC, SFSB, GBSB 
Display RMS structures for all IFI values. 


The SHOW RMS command displays the full set of options available for 
display by the SHOW PROCESS/RMS command. SDA, by default, selects the 
full set of RMS options at the beginning of an analysis. 


2. SDA> SET RMS=(IFAB=1,CCB,WCB) 
SDA> SHOW RMS 
RMS Display Options: IFB,CCB,WCB 
Display RMS structures only for IFI = 0001 
The SET RMS command establishes the IFB, CCB, and WCB as the 
structures to be displayed, and only for the file whose internal File Identifer 


has the value 1, when the SHOW PROCESS/RMS command is issued. The 
SHOW RMS command verifies this selection of RMS options. 
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SHOW RSPID 


Format 


Parameters 


Qualifier 


Description 


Displays information about response IDs (RSPIDs) of all System Communications 
Services (SCS) connections or, optionally, about a specific SCS connection. 


SHOW RSPID [/CONNECTION=cat-adaress] 


None. 


/CONNECTION=cat-address 

Displays RSPID information for the specific SCS connection whose connection 
descriptor table (CDT) address is provided in cdt-address. You can find the cdt- 
address for any active connection on the system in the CDT summary page 
display of the SHOW CONNECTIONS command. CDT addresses are also stored 
in many individual data structures related to SCS connections. These data 
structures include class driver request packets (CDRPs) and unit control blocks 
(UCBs) for class drivers that use SCS and cluster system blocks (CSBs) for the 
connection manager. 


Whenever a local system application (SYSAP) requires a response from a remote 
SYSAP, a unique number, called an RSPID, is assigned to the response by the 
local system. The RSPID is transmitted in the original request (as a means of 
identification), and the remote SYSAP returns the same RSPID in its response to 
the original request. 


The SHOW RSPID command displays information taken from the response 
descriptor table (RDT), which lists the currently open local requests that require 
responses from SYSAPs at a remote node. For each RSPID, SDA displays the 
following information: 


e RSPID value 


e Address of the class driver request packet (CDRP), which generally represents 
the original request 


e Address of the CDT that is using the RSPID 
e Name of the local process using the RSPID 


e Remote node from which a response is required (and has not yet been 
received) 
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1. SDA> SHOW RSPID 


--- Summary of Response Descriptor Table (RDT) 805E6F18 --- 


RSPID CDRP Address CDT Address Local Process Name Remote Node 
39D00000 8062CC80 805E8710 VMSSVMScluster VANDQ1 
EE210001 80637260 805E8C90 VMSSDISK CL DRVR ROMRDR 
EE240002 806382E0 805E8DF0 VMSSDISK CL DRVR VANDO1 
EE440003 806393E0 805E8F50 VMS$TAPE_CL_DRVR VANDQ1 
5DB90004 80636BC0 805E8870 VMSSVMScluster ROMRDR 
5C260005 80664040 805E8870 VMSSVMScluster ROMRDR 
38F80006 80664A80 805E8710 VMSSVMScluster VANDQ1 


This example shows the default output for the SHOW RSPID command. 


2. SDA> SHOW RSPID/CONNECTION=805E8F50 


--- Summary of Response Descriptor Table (RDT) 805E6F18 --- 
RSPID CDRP Address CDT Address Local Process Name Remote Node 


EE440003 806393E0 805E8F50 VMS$TAPE_CL_DRVR VANDQ1 
This example shows the output fora SHOW RSPID/CONNECTION command. 
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SHOW SHM_CPP 


Format 


Parameters 


Qualifiers 


Displays information about the shared memory common property partitions 
(CPPs). The default display shows a single-page summary that includes a single 
line for each CPP. 


SHOW SHM_CPP_ [/ QUALIFIERS] 


None. 


/ADDRESS=n 
Displays a detailed page of information about an individual shared memory CPP 
given the address of the SHM_CPP structure. 


/ALL 
Displays a detailed page of information about each shared memory CPP. 


AIDENT=n 
Displays a detailed page of information about an individual shared memory CPP. 


/PFN [=option] 

Displays PFN data in addition to the basic SHM_CPP. The default is all lists 
(free, bad, untested), plus the PFN database pages and the complete range of 
PFNs in the CPP. 


To display only the complete range of PFNs in the CPP, use the keyword ALL_ 
FRAGMENTS with the /PFN qualifier: 


/PEFN = ALL FRAGMENTS 
To display only the bad page list, use the keyword BAD with the /PFN qualifier: 


/PFN = BAD 
To display only the free page list, use the keyword FREE with the /PFN qualifier: 
/PFN = FREE 


To display the PFNs containing the PFN database, use the keyword PFNDB with 
the /PFN qualifier: 


/PFN = PFNDB 


To display only the untested page list, use the keyword UNTESTED with the 
/PFN qualifier: 


/PFN = UNTESTED 
To display multiple lists, you can combine keywords with the /PFN qualifier: 
/PEN = (x,y) 


If you specify /PFN without /ALL, /IDENT, or /ADDRESS, then the system 
displays the PFN lists from the last shared memory CPP accessed. 
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Examples 


1. SDA> SHOW SHM_CPP 


Summary of Shared Memory Common Property Partitions 


Base address of SHM CPP array: FFFFFFFF.7F2BA140 


Maximum number of SHM_CPP entries: 00000007 
Size of each SHM_CPP: 00000240 
Maximum fragment count per SHM_CPP: 00000010 
Valid CPP count: 00000001 


MinPFN MaxPFN 


ID SHM_CPP address 


-- SHM_CPP IDs 0000 to 0002: VALID flag clear -- 
0003 FFFFFFFF.7F2BA800 00060000 0007FFFF 00020000 

-- SHM_CPP IDs 0004 to 0006: VALID flag clear -- 
This example shows the default output for the SHOW SHM_CPP command. 


Page count Free pages 


Flags 


Q001FCF7 00000001 VALID 


2. SDA> SHOW SHM_CPP/IDENT=3 
Shared Memory CPP 0003 


SHM_CPP address: FFFFFFFF.7F2BA800 


Version: 00000001 # Flags: 00000001 VALID 
Size: 00000000.000000C0 Page count: 00020000 

Actual fragment count: 00000001 Minimum PFN: 00060000 
Maximum fragment count: 00000010 Maximum PFN: 0007FFFF 
Length of free page list: 0001FCF7 

Length of bad page list: 00000000 

Length of untested page list: 00000000 


PMAP array for PFN database pages 


PMAP Start PFN PFN count 
0. 00060053 00000280 
PMAP array for all fragments 
PMAP Start PFN PFN count 
0. 00060000 00020000 
GLock address: FFFFFFFF.7F2BA8C0 Handle: 80000000.00010D19 
GLock name: SHM_CPP00000003 Flags: 00 
Owner count: 00 Owner node: 00 
Node sequence: 0000 Owner: 000000 
IPL: 08 Previous IPL: 00 
Wait bitmask: 00000000.00000000 Timeout: 00249F00 
Thread ID: 00000000.00000000 
Connected GNode bitmask: FFFFFFFF.7F2BA900 
Valid bits: 00000004 # State: 00000000.00000000 
Unit count: 0001 Unit size: QUADWORD 
Unit bitmask: 
Ceesacetexetece- seGvise.dcntehiands, teuagaliengl acetate anatase eters 7 00000000 
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Ranges of free pages 
Range Start PFN PFN count 


1s 000602F6 00000002 
2. 0006030B Q001FCF5 


This example shows the details for a single SHM_CPP. 
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SHOW SHM_REG 


Displays information about shared memory regions. The default display shows a 
single page summary that includes a single line for each region. 


Format 


SHOW SHM_REG _ [/ QUALIFIERS] [name] 


Parameter 


name 
Detailed page of information about the named region. 


Qualifiers 


/ADDRESS=n 
Displays a detailed page of information about an individual region given the 
address of the SHM_REG structure. 


/ALL 
Displays a detailed page of information about each region. 


ADENT=n 
Displays a detailed page of information about the specified region. 


Examples 
1. SDA> SHOW SHM_REG 


Summary of Shared Memory Regions 


Base address of SHM REG array: FFFFFFFF.7F2BB140 
Maximum number of SHM REG entries: 00000040 
Size of each SHM REG: 00000208 
Base address of SHM DESC array: FFFFFFFF .7F2DC000 
Valid region count: 00000009 
ID  SHM_REG address Region Tag SysVA / GSTX Flags 
0000 FFFFFFFF.7F2BB140 SYSSGALAXY MANAGEMENT DATABASE FFFFFFFF.7F234000 00000001 VALID 
0001 FFFFFFFF.7F2BB348 SYSSSHARED MEMORY PFN DATABASE FFFFFFFE.00000000 00000001 VALID 
0002 FFFFFFFF.7F2BB550 SMCISSECTION PBA 04001 -<None>- 00000001 VALID 
0003 FFFFFFFF.7F2BB758 GLX$CPU$BALANCERSSYSGBL 0000013F 00000005 VALID SHARED CONTEXT VALID 
0004 FFFFFFFF.7F2BB960 SMCISCHANNEL PBA 0 1 FFFFFFFF.8F3AE000 00000001 VALID 7 ~ 
0005 FFFFFFFF.7F2BBB68 SMCISCHANNEL PBA 0 2 FFFFFFFF.8FAEE000 00000001 VALID 
0006 FFFFFFFF.7F2BBD70 SMCISCHANNEL PBA 1 2 -<Not Attached>- 00000001 VALID 
0007 FFFFFFFF.7F2BBF78 LANSSHM_REG FFFFFFFF.7F20C000 00000009 VALID ATTACH DETACH 
0008 FFFFFFFF.7F2BC180 GLX$CPU_BAL GLOCK $000006 00000140 00000005 VALID SHARED CONTEXT VALID 


SHM_REG IDs 0009 to 003F: never used -- 


This example shows the summary of all shared memory regions in the system. 
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2. SDA> SHOW SHM REG SMCISCHANNEL PBA 0 1 


SHM_REG address: 


Version: 
Index/Sequence: 


Region tag: 
Creation time: 


SHM_DESC address: 


Version: 

System VA: 

I/O ref count: 
Index/Sequence: 
Callback: 


MMAP address: 


Level count: 
Top page count: 


PFN list page count: 


Data page count: 
GLock address: 


GLock name: 
Owner count: 
Node sequence: 
IPL: 

Wait bitmask: 
Thread ID: 


Attached GNode bitmask: 


Valid bits: 
Unit count: 
Lock IPL: 


Count of bits set: 


Unit bitmask: 


I/O in progress bitmask: 


Valid bits: 
Unit count: 
Lock IPL: 


Count of bits set: 


Unit bitmask: 


SHM_CPP bitmask: 


Valid bits: 
Unit count: 


Unit bitmask: 


FFFFFFFF .7F2BB960 


00000001 
0004/00000003 


SMCISCHANNEL PBA 0 1 


Flags: 


Size: 00000000. 


31-MAR-1999 14:11:11.37 


FFFFFFFF .7F2DC200 


00000001 
FFFFFFFF . 8F3AE000 
00000000.00000000 

0004/00000003 
FFFFFFFF . 8F38E5C0 


FFFFFFFF .7F2BB9E0 


0001 
00000001 
00000001 
00000009 


FFFFFFFF .7F2BBA80 
SHM_REG00000004 


00000000.00000000 
00000000.00000000 


FFFFFFFF .7F2BBAC0 


00000004 
0001 

08 
00000002 


FFFFFFFF.7F2BBAF8 


00000004 
0001 

08 
00000000 


FFFFFFFF .7F2BBB30 


00000007 
0001 


Flags: 
Virtual size: 


Context: 
SYSSPBDRIVER+185C0 


Flags: 
Virtual size: 
First PFN: 


Handle: 


Flags: 

Owner node: 
Owner: 
Previous IPL: 
Timeout: 


State: 
Unit size: 
Saved IPL: 


00000000 


State: 
Unit size: 
Saved IPL: 


00000000 


State: 
Unit size: 


00000000 ) 


00000000. 


FFFFFFFF. 


00000000. 


80000000. 


00000000. 


00000000. 


00000000. 


00000001 
00000120 


00000005 
00274000 


80F42480 


0001 
00274000 
000602D4 


00010F51 


00 

00 
000000 
00 
002DC6C0 


00000012 
QUADWORD 
00000008 


00000012 
QUADWORD 
00000000 


00000000 
QUADWORD 
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VALID 


ATTACHED SYS _VA_VALID 


VALID 


AUTO LOCK SET COUNT 


AUTO LOCK SET COUNT 


This example shows the details for a single shared memory region. 
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SHOW SPINLOCKS 


Format 


Parameter 


Qualifiers 


Displays the multiprocessing synchronization data structures. 


SHOW SPINLOCKS  {[name]!/ADDRESS=expression | /INDEX=expression} 
[/COUNTS |/OWNED |/DYNAMIC |/STATIC 
|/PCB|/PORT |/CACHED_PCB|/MAILBOX] [{/BRIEF |/FULL}] 


name 

Name of the spinlock to be displayed. Device spinlock names are of the form 
node$lock, where node indicates the OpenVMS Cluster node name and lock 
indicates the device and controller identification (for example, HAETAR$DUA). 
If there is no OpenVMS Cluster node name, the dollar sign ($) is also skipped 
(for example, DUA). This parameter cannot be used to identify mailbox, PCB, or 
cached PCB spinlocks. 


/ADDRESS=expression 

Displays the spinlock at the address specified in expression. You can use the 
/ADDRESS qualifier to display a specific device, mailbox, PCB, or cached PCB 
spinlock; however, the name of the spinlock is listed as “Unknown” in the display. 


/BRIEF 

Produces a condensed display of the spinlock information displayed by default 
by the SHOW SPINLOCKS command, including the following: address, spinlock 
name or device name, IPL or device IPL, rank, ownership depth, and CPU ID of 
the owner CPU. If the system under analysis was executing with full-checking 
multiprocessing enabled (according to the setting of the MULTIPROCESSING 
or SYSTEM_CHECK system parameter), then the number of waiting CPUs and 
interlock status are also displayed. 


/CACHED_PCB 
Displays all PCB-specific spinlocks associated with PCBs of deleted processes. 


/COUNTS 
Produces a display of Spin, Wait, and Acquire counts for each spinlock (only if 
full-checking multiprocessing is enabled). 


/DYNAMIC 
Displays information for all dynamic spinlocks in the system (device, port, 
mailbox, PCB, and cached PCB spinlocks). 


/FULL 
Displays full descriptive and diagnostic information for each displayed spinlock. 


NINDEX=expression 
Displays the static spinlock whose index is specified in expression. You can only 
use the /INDEX qualifier to display a named static spinlock. 
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Description 
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/MAILBOX 
Displays all mailbox-specific spinlocks. 


/OWNED 
Displays information for all spinlocks owned by a CPU. If no processors own any 
spinlocks, SDA displays the following message: 


%SDA-I-NOSPLOWNED, all requested spinlocks are unowned 


/PCB 
Displays all PCB-specific spinlocks. 


/PORT 
Displays all port spinlocks. 


/STATIC 
Displays information for all static spinlocks in the system. 


The SHOW SPINLOCKS command displays status and diagnostic information 
about the multiprocessing synchronization structures known as spinlocks. 


A static spinlock is a spinlock whose data structure is permanently assembled 
into the system. Static spinlocks are accessed as indexes into a vector of longword 
addresses called the spinlock vector, the address of which is contained in 
SMP$AR_SPNLKVEC. Table 4—28 lists the static spinlocks. 


A dynamic spinlock is a spinlock that is created based on the configuration of a 
particular system. One such dynamic spinlock is the device lock SYSMAN creates 
when configuring a particular device. This device lock synchronizes access to the 
device’s registers and certain UCB fields. The system creates a dynamic spinlock 
by allocating space from nonpaged pool, rather than assembling the lock into the 
system as it does in creating a static spinlock. Other types of dynamic spinlocks 

are: port spinlocks, mailbox spinlocks, PCB and cached PCB spinlocks. 


See the Writing OpenVMS Alpha Device Drivers in C for a full discussion of the 
role of spinlocks in maintaining synchronization of kernel-mode activities in a 
multiprocessing environment. 


Table 4-28 Static Spinlocks 


Name Description 

QUEUEAST Spinlock for queuing ASTs at IPL 6 

FILSYS Spinlock on file system structures 

LCKMGR Spinlock on all lock manager structures 

IOLOCK8/SCS Spinlock for executing a driver fork process at IPL 8 
TX_SYNCH Transaction processing spinlock 

TIMER Spinlock for adding and deleting timer queue entries and 


searching the timer queue 


PORT Template structure for dynamic spinlocks for ports with 
multiple devices 


(continued on next page) 
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Table 4—28 (Cont.) Static Spinlocks 


Name Description 

IO_MISC Miscellaneous short-term I/O spinlocks 

MMG Spinlock on memory management, PFN database, swapper, 
modified page writer, and creation of per-CPU database 
structures 

SCHED Spinlock on some process data structures and the scheduler 
database. 

IOLOCK9 Spinlock for executing a driver fork process at IPL 9 

IOLOCK10 Spinlock for executing a driver fork process at IPL 10 

IOLOCK11 Spinlock for executing a driver fork process at IPL 11 

MAILBOX Spinlock for sending messages to the permanent system 
(OPCOM, JOBCTL, and so on) mailboxes 

POOL Spinlock on nonpaged pool database 

PERFMON Spinlock for I/O performance monitoring 

INVALIDATE Spinlock for system space translation buffer (TB) invalidation 

HWCLK Spinlock on hardware clock database, including the 


quadword containing the due time of the first timer queue 
entry (EXE$GQ_1ST_TIME) and the quadword containing 
the system time (EXE$GQ_SYSTIME) 
MEGA Spinlock for serializing access to fork-wait queue 
EMB/MCHECK Spinlock for allocating and releasing error-logging buffers 
and synchronizing certain machine error handling 


For each spinlock in the system, SHOW SPINLOCKS provides the following 
information: 


e Name of the spinlock (or device name for the device lock) 

e Address of the spinlock data structure (SPL) 

e The owning CPU’s CPU ID 

e IPL at which allocation of the lock is synchronized on a local processor 


e Number of nested acquisitions of the spinlock by the processor owning the 
spinlock (Ownership Depth) 


e Rank of the spinlock 

e Timeout interval for spinlock acquisition (in terms of 10 milliseconds) 
e Shared array (shared spinlock context block pointer) 

e Number of processors waiting to obtain the spinlock 


e Interlock (synchronization mutex used when full-checking multiprocessing is 
enabled) 


The last two items (CPUs waiting and Interlock) are only displayed if full- 
checking multiprocessing is enabled. 


SHOW SPINLOCKS/BRIEF produces a condensed display of this same 
information, excluding the share array and timeout interval. 
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SHOW SPINLOCKS/COUNTS displays only the Spin, Wait, and Acquire counts 


for each spinlock. 


If the system under analysis was executing with full-checking multiprocessing 
enabled, SHOW SPINLOCKS/FULL adds to the spinlock display the Spin, Wait, 
and Acquire counts and the last sixteen PCs at which the lock was acquired or 
released. If applicable, SDA also displays the PC of the last release of multiple, 
nested acquisitions of the lock. 


If no spinlock name, address, or index is given, then information is displayed for 


all applicable spinlocks. 


Examples 


I, 


SDA> SHOW SPINLOCKS 


System static spinlock structures 


EMB 

Owner CPU ID 
Ownership Depth 
Timeout Interval 
CPUs Waiting 


MCHECK 

Owner CPU ID 
Ownership Depth 
Timeout Interval 
CPUs Waiting 


MEGA 

Owner CPU ID 
Ownership Depth 
Timeout Interval 
CPUs Waiting 


HWCLK 

Owner CPU ID 
Ownership Depth 
Timeout Interval 
CPUs Waiting 


System dynamic spinlock structures 


QOTV14SOPA 

Owner CPU ID 
Ownership Depth 
Timeout Interval 
CPUs Waiting 


QOTV14SMBA 

Owner CPU ID 
Ownership Depth 
Timeout Interval 
CPUs Waiting 


OTV14SNLA 

Owner CPU ID 
Ownership Depth 
Timeout Interval 
CPUs Waiting 


None 
FFFFFFFF 
000186A0 
00000000 


None 
FFFFFFFF 
000186A0 
00000000 


None 
FFFFFFFF 
000186A0 
00000000 


None 
FFFFFFFF 
000186A0 
00000000 


None 
FFFFFFFF 
000186A0 
00000000 


None 
FFFFFFFF 
000186A0 
00000000 


None 
FFFFFFFF 
000186A0 
00000000 


Address 

IPL 

Rank 

Share Array 
Interlock 


Address 

IPL 

Rank 

Share Array 
Interlock 


Address 

IPL 

Rank 

Share Array 
Interlock 


Address 

IPL 

Rank 

Share Array 
Interlock 


Address 
DIPL 

Rank 

Share Array 
Interlock 


Address 

IPL 

Rank 

Share Array 
Interlock 


Address 

IPL 

Rank 

Share Array 
Interlock 


810AE300 
0000001F 
00000000 
00000000 
Free 


810AE300 
0000001F 
00000000 
00000000 
Free 


810AE400 
0000001F 
00000002 
00000000 
Free 


810AE500 
00000016 
00000004 
00000000 
Free 


8103FB00 
00000015 
FFFFFFFF 
00000000 
Free 


810AE900 
00000008 
0000000C 
00000000 
Free 


810AE900 
00000008 
0000000C 
00000000 
Free 
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SHOW SPINLOCKS 
QOTV14SPKA Address 814AA100 
Owner CPU ID None DIPL 00000015 
Ownership Depth FFFFFFFF Rank FFFFFFFF 
Timeout Interval  000186A0 Share Array 00000000 


CPUs Waiting 00000000 Interlock Free 


This excerpt illustrates the default output of the SHOW SPINLOCKS command. 


2. SDA> SHOW SPINLOCKS/BRIEF 


System static spinlock structures 


Spinlock Owner CPUs 
Address Name IPL Rank Depth CPU Waiting Interlock 
810AE300 EMB 001F 00000000 FFFFFFFF None 00000000 Free 
810AE300 MCHECK 001F 00000000 FFFFFFFF None 00000000 Free 
810AE400 MEGA 001F 00000002 FFFFFFFF None 00000000 #£Free 
810AE500 HWCLK 0016 00000004 FFFFFFFF None 00000000 Free 
810AE600 INVALIDATE 0015 00000006 FFFFFFFF None 00000000 #£Free 
810AE700 PERFMON 000F 00000008 FFFFFFFF None 00000000 Free 
810AE800 POOL 000B 0000000A FFFFFFFF None 00000000 Free 
810AE900 MAILBOX 000B 0000000C FFFFFFFF None 00000000 Free 
810AEA00 IOLOCK11 000B 0000000E FFFFFFFF None 00000000 Free 
810AEB00 IOLOCK10 000A 0000000F FFFFFFFF None 00000000 Free 
810AEC00 IOLOCK9 0009 00000010 FFFFFFFF None 00000000 Free 
810AED00 SCHED 0008 00000012 00000000 00000000 00000001 Free 
810AEE00 MMG 0008 00000014 FFFFFFFF None 00000000 Free 
810AEF00 IO MISC 0008 00000016 FFFFFFFF None 00000000 Free 
810AF000 PORT 0008 00000017 FFFFFFFF None 00000000 Free 
810AF100 TIMER 0008 00000018 00000000 00000000 00000000 Free 
810AF200 TX SYNCH 0008 00000019 FFFFFFFF None 00000000 Free 
810AF300 SCS 0008 0000001A FFFFFFFF None 00000000 Free 
810AF400 LCKMGR 0008 0000001B FFFFFFFF None 00000000 Free 
810AF500 FILSYS 0008 0000001C FFFFFFFF None 00000000 Free 


810AF600 QUEUEAST 0006 0000001E FFFFFFFF None 00000000 Free 


System dynamic spinlock structures 


Device Owner CPUs 
Address Name DIPL Rank Depth CPU Waiting Interlock 


8103FB00 QTV14SOPA 0015 FFFFFFFF FFFFFFFF None 00000000 Free 
810AE900 QTV14SMBA 000B 0000000C FFFFFFFF None 00000000 Free 
810AE900 QTV14SNLA 000B 0000000C FFFFFFFF None 00000000 # Free 
814AA100 OTV14SPKA 0015 FFFFFFFF FFFFFFFF None 00000000 Free 


This excerpt illustrates the condensed form of the display produced in the first 
example. 
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SDA> SHOW SPINLOCKS/FULL SCHED 


System static spinlock structures 


SCHED Address 810AED00 
Owner CPU ID 00000000 IPL 00000008 
Ownership Depth 00000000 Rank 00000012 
Timeout Interval 002DC6C0 Share Array 00000000 
CPUs Waiting 00000001 Interlock Free 
Spins 00000000.0458E8DC Busy waits 00252E8D 
Acquires 00000000.01279BE0 


Spinlock SPLS$C SCHED was last acquired or released from: 


(Most recently) 


(Least recently) 


8004AD00 
8004B1D4 
8004AD00 
8004B1D4 
8004AD00 
8004B1D4 
8004AD00 
8004B1D4 
8004AD00 
80136A2C 
80117580 
8004B230 
8004AFC4 
80117360 
8012E5F4 
80132150 


EXESSWTIMER FORK C+00170 
EXESSWTIMER FORK C+00644 
EXESSWTIMER FORK C+00170 
EXESSWTIMER FORK C+00644 
EXESSWTIMER FORK C+00170 
EXESSWTIMER FORK C+00644 
EXESSWTIMER FORK C+00170 
EXESSWTIMER FORK C+00644 
EXESSWTIMER FORK C+00170 
SCHSINTERRUPT+0070C 
SCHSIDLE C+002A0 
EXESSWTIMER FORK C+006A0 
EXESSWTIMER FORK C+00434 
SCHSIDLE C+00080 
EXESHIBER INT C+00074 
EXESSCHDWK_C+00110 


Last release of multiple acquisitions occurred at: 


80262A54 EXESCHECK VERSION C+009F4 
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This display shows the detailed information on the SCHED spinlock, including 


the PC history. 
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SHOW STACK 


Format 


Parameter 


Qualifiers 


Displays the location and contents of the process stacks (of the SDA current 
process) and the system stack. 


SHOW STACK {range | /ALL [/EXECUTIVE | /INTERRUPT |/KERNEL 
|/PHYSICAL|/SUMMARY | /SUPERVISORI/SYSTEM |/USER]} 
{LONG | /QUAD (d)} 


range 
Range of memory locations you want to display in stack format. You can express 
a range using the following syntax: 

m:n Range of addresses from m to n 

m;n Range of addresses starting at m and continuing for n bytes 


/ALL 
Displays the locations and contents of the four process stacks for the SDA current 
process and the system stack. 


/EXECUTIVE 
Shows the executive stack for the SDA current process. 


ANNTERRUPT 
Shows the system stack and is retained for compatibility with OpenVMS VAX. 
The interrupt stack does not exist in OpenVMS Alpha. 


/KERNEL 
Shows the kernel stack for the SDA current process. 


/LONG 
Displays longword width stacks. If you do not specify this qualifier, SDA by 
default displays quadword width stacks. 


/PHYSICAL 

Treats the start and end addresses in the given range as physical addresses. This 
qualifier is only relevant when a range is specified. By default, SDA treats range 
addresses as virtual addresses. 


/QUAD 
Displays quadword width stacks. This is the default. 


/SUMMARY 
Displays a list of all known stack ranges and the current stack pointer for each 
range. 


/SUPERVISOR 
Shows the supervisor stack for the SDA current process. 
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/SYSTEM 
Shows the system stack. 


/USER 
Shows the user stack for the SDA current process. 


The SHOW STACK command, by default, displays the stack that was in use when 
the system failed, or, in the analysis of a running system, the current operating 
stack. For a process that became the SDA current process as the result of a SET 
PROCESS command, the SHOW STACK command by default shows its current 
operating stack. 


The various qualifiers to the command allow display of any of the four per-process 
stacks for the SDA current process, as well as the system stack for the SDA 
current CPU. In addition, any given range can be displayed in stack format. 


You can define SDA process and CPU context by using the SET CPU, SHOW 
CPU, SHOW CRASH, SET PROCESS, and SHOW PROCESS commands as 
indicated in their command descriptions. A complete discussion of SDA context 
control appears in Section 2.5. 


SDA provides the following information in each stack display: 


Section Contents 

Identity of stack SDA indicates whether the stack is a process stack (user, 
supervisor, executive, or kernel) or the system stack. 

Stack pointer The stack pointer identifies the top of the stack. The 
display indicates the stack pointer by the symbol SP =>. 

Stack address SDA lists all the addresses that the operating system 


has allocated to the stack. The stack addresses are listed 
in a column that increases in increments of 8 bytes (one 
quadword) unless you specify the /LONG qualifier, in 
which case addresses are listed in increments of 4 (one 


longword). 

Stack contents SDA lists the contents of the stack in a column to the 
right of the stack addresses. 

Symbols SDA attempts to display the contents of a location 


symbolically, using a symbol and an offset. 

If the stack is being displayed in quadword width and 
the location cannot be symbolized as a quadword, SDA 
attempts to symbolize the least significant longword and 
then the most significant longword. If the address cannot 
be symbolized, this column is left blank. 


Canonical stack When displaying the kernel stack of a noncurrent process 
in a crash dump, SDA identifies the stack locations used 
by the scheduler to store the register contents of the 
process. 
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Section Contents 


Mechanism array When displaying the current stack in a FATALEXCPT, 

Signal array INVEXCEPTN, SSRVEXCEPT, or UNXSIGNAL bugcheck, 

Exception frame SDA identifies the stack locations used to store registers 
and other key data for these structures. 


If a stack is empty, the display shows the following: 


SP => (STACK IS EMPTY) 


Examples 


SDA> SHOW STACK 
1. current Operating Stack (SYSTEM): 

FFFFFFFF.8244BD08 FFFFFFFF.800600FC SCHS$REPORT EVENT C+000FC 
FFFFFFFF.8244BD10 00000000.00000002 
FFFFFFFF.8244BD18 00000000.00000005 
FFFFFFFF.8244BD20 FFFFFFFF.8060C7C0 

SP => FFFFFFFF.8244BD28 FFFFFFFF.8244BEE8 
FFFFFFFF.8244BD30 FFFFFFFF.80018960 EXESHWCLKINT C+00260 
FFFFFFFF.8244BD38 00000000.000001B8 
FFFFFFFF.8244BD40 00000000.00000050 
FFFFFFFF.8244BD48 00000000.00000210 UCBSN RSID+00002 
FFFFFFFF.8244BD50 00000000.00000000 ~ 
FFFFFFFF.8244BD58 00000000.00000000 
FFFFFFFF.8244BD60 FFFFFFFF.804045D0 SCH$GQ_IDLE CPUS 
FFFFFFFF.8244BD68 FFFFFFFF.8041A340 EXESGL FKWAITFL+00020 
FFFFFFFF.8244BD70 00000000.00000250 UCB$T_MSGDATA+00034 
FFFFFFFF.8244BD78 00000000.00000001 


CHFSIS MCH ARGS FFFFFFFF.8244BD80 00000000.0000002B 

CHF$PH MCH FRAME FFFFFFFF.8244BD88 FFFFFFFF.8244BFBO0 

CHFSIS MCH DEPTH FFFFFFFF.8244BD90 80000000.FFFFFFFD G 

CHF$PH MCH DADDR FFFFFFFF.8244BD98 00000000.00001600 CTLS$C_CLIDATASZ+00060 


CHF$PH_MCH ESF ADDR FFFFFFFF.8244BDA0 FFFFFFFF.8244BF40 
CHFSPH MCH SIG ADDR FFFFFFFF.8244BDA8 FFFFFFFF.8244BEE8 


CHFSIH MCH SAVRO FFFFFFFF.8244BDB0 FFFFFFFF.8041FB00 SMPSRELEASEL+00640 
CHFSIH MCH SAVR1 FFFFFFFF.8244BDB8 00000000.00000000 

CHFSIH MCH SAVR16 FFFFFFFF.8244BDC0 00000000.0000000D 

CHF$IH MCH SAVR17 FFFFFFFF.8244BDC8 0000FFF0.00007E04 

CHFSIH MCH SAVR18 FFFFFFFF.8244BDD0 00000000.00000000 

CHFS$IH MCH SAVR19 FFFFFFFF.8244BDD8 00000000.00000001 

CHFSIH MCH SAVR20 FFFFFFFF.8244BDE0 00000000.00000000 

CHFS$IH MCH SAVR21 FFFFFFFF.8244BDE8 FFFFFFFF.805AE4B6 SISR+0006E 
CHFSIH MCH SAVR22 FFFFFFFF.8244BDF0 00000000.00000001 

CHFS$IH MCH SAVR23 FFFFFFFF.8244BDF8 00000000.00000010 

CHFSIH MCH SAVR24 FFFFFFFF.8244BE00 00000000.00000008 

CHFS$IH MCH SAVR25 FFFFFFFF.8244BE08 00000000.00000010 

CHFSIH MCH SAVR26 FFFFFFFF.8244BE10 00000000.00000001 

CHFS$IH MCH SAVR27 FFFFFFFF.8244BE18 00000000.00000000 

CHF$IH_MCH_SAVR28 FFFFFFFF.8244BE20 FFFFFFFF.804045D0 SCHSGOQ IDLE CPUS 


FFFFFFFF.8244BE28 30000000.00000300 UCBSL PI SVA 
FFFFFFFF.8244BE30 FFFFFFFF.80040F6C EXESREFLECT_C+00950 
FFFFFFFF.8244BE38 18000000.00000300 UCBSL PI SVA 
FFFFFFFF.8244BE40 FFFFFFFF.804267A0 EXESCONTSIGNAL+00228 
FFFFFFFF.8244BE48 00000000. 7FFD00A8 PIOSGW_IIOIMPA 
FFFFFFFF.8244BE50 00000003.00000000 

FFFFFFFF.8244BE58 FFFFFFFF.8003FC20 EXESCONNECT SERVICES C+00920 
FFFFFFFF.8244BE60 FFFFFFFF.8041FB00 SMPSRELEASEL+00640 ~ 
FFFFFFFF.8244BE68 00000000.00000000 

FFFFFFFF.8244BE70 FFFFFFFF.8042CD50 SCHSWAIT PROC+00060 
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CHF$L_SIG_ARGS 
CHFSL_SIG_ARG1 


INTSTKSO R2 
INTSTKSO R3 
INTSTKSO R4 
INTSTKSO R5 
INTSTKSO R6 
INTSTKSO R7 
INTSTKSQ PC 
INTSTK$Q_PS 


Prev SP (82 


FFFFFFFF .8244BE78 
FFFFFFFF .8244BE80 
FFFFFFFF .8244BE88 
FFFFFFFF .8244BE90 
FFFFFFFF .8244BE98 
FFFFFFFF .8244BEA0 
FFFFFFFF .8244BEA8 
FFFFFFFF .8244BEB0 
FFFFFFFF .8244BEB8 
FFFFFFFF .8244BEC0 
FFFFFFFF .8244BEC8 
FFFFFFFF .8244BED0 
FFFFFFFF .8244BED8 
FFFFFFFF .8244BEE0 
FFFFFFFF .8244BEE8 
FFFFFFFF .8244BEF0 
FFFFFFFF .8244BEF8 
FFFFFFFF .8244BF00 
FFFFFFFF .8244BF08 
FFFFFFFF.8244BF10 
FFFFFFFF.8244BF18 
FFFFFFFF .8244BF20 
FFFFFFFF .8244BF28 
FFFFFFFF .8244BF30 
FFFFFFFF .8244BF38 
FFFFFFFF.8244BF40 
FFFFFFFF .8244BF48 
FFFFFFFF.8244BF50 
FFFFFFFF .8244BF58 
FFFFFFFF.8244BF60 
FFFFFFFF .8244BF68 
FFFFFFFF .8244BF70 
FFFFFFFF.8244BF78 
FFFFFFFF .8244BF80 
FFFFFFFF .8244BF88 
FFFFFFFF .8244BF90 
FFFFFFFF .8244BF98 
FFFFFFFF .8244BFA0 
FFFFFFFF .8244BFA8 
FFFFFFFF .8244BFB0 
FFFFFFFF .8244BFB8 
FFFFFFFF .8244BFC0 
FFFFFFFF .8244BFC8 
FFFFFFFF .8244BFD0 
FFFFFFFF .8244BFD8 
FFFFFFFF .8244BFE0 
FFFFFFFF .8244BFE8 
FFFFFFFF .8244BFF0 
FFFFFFFF.8244BFF8 


44BFBO) => 


00000000. 
QOOOFFFO. 
00000000. 
00000000. 
00000000. 
FFFFFFFF. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
FFFFFFFF. 
00000000. 
0000000C. 
FFFFFFFC. 
00000300 
00000002. 
00000000. 
00000000. 
00000000 
00000008. 
00000000. 
00000008. 
00000000 
FFFFFFFF. 
FFFFFFFF 
FFFFFFFF 
00000000. 
FFFFFFFF. 
00000000. 
00000000 
30000000. 
FFFFFFFF 
00000000. 
00000000. 
FFFFFFFF. 
00000000. 
FFFFFFFF 
FFFFFFFF 
00000000. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF 
FFFFFFFF 
00000000. 
FFFFFFFF. 
00000000. 


0000000D 
00007E04 
00000000 
00000001 
00000000 
805AE4B6 
00000001 
00000010 
00000008 
00000010 
00000001 
00000000 
804045D0 
00000001 
00000005 
00010000 


» FFFFFFFC 


00000001 
0000000C 
00000000 


» FFFFFFFC 


00000000 
00000001 
00000000 


» FFFFFFFC 


80404668 


-8042F280 
-80615F00 


00000000 
805AE000 
00000000 


» FFFFFFFC 


00000300 


- 80404668 


7FFDO0A8 
00000000 
8042CD50 
00000044 


-80403C30 
-8042CD50 


00000000 
805EE040 
8006DB54 
80404668 


-80615F00 
-8041B220 


00000044 
80403C30 
TFF95E00 
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SISR+0006E 


SCH$GQ_IDLE_CPUS 


SYS$K_VERSION_08 
UCBSL_PI_SVA 


SCHSGL_ACTIVE PRIORITY 
SCHSWAIT_KERNEL_ MODE 


UCB$L_PI_SVA 

SCHSGL_ACTIVE PRIORITY 
PIOSGW_IIOIMPA 
SCHSWAIT_PROC+00060 
SMP$GL_FLAGS 
SCHSWATT_PROC+00060 

PROCESS MANAGEMENT NPRO+0DB54 
SCHS$GL_ACTIVE PRIORITY 
SCHSRESOURCE_WAIT 


SMP$GL_FLAGS 


The SHOW STACK command displays a system stack on an OpenVMS Alpha 
system. The data shown before the stack pointer may not be valid. The 
mechanism array, signal array, and exception frame symbols displayed on the left 
appear only for INVEXCEPTN, FATALEXCPT, UNXSIGNAL, and SSRVEXCEPT 


bugchecks. 
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SDA> SHOW STACK/SUMMARY 
Stack Ranges 


This example 
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shows the stack ranges for a process on an OpenVMS I[64 system. 


Stack Stack Base Stack Limit Stack Pointer Notes 
Kernel 00000000.7FF44000 00000000.7FF2C000 00000000.7FF43EB0 Current 
Executive 00000000.7FF68000 00000000.7FF58000  00000000.7FF68000 
Supervisor 00000000.7FFACO00 00000000.7FFA8000  00000000.7FFAC000 
User 00000000.3FFE2000 00000000.3FFCA000 00000000.3FFE1FBO #KPstack 
User 00000000.3FFFE000 00000000.3FFE6000 00000000.3FFFDDBO KPstack 
User 00000000.7AC9E000  00000000.7AC9A000 00000000.7AC9D830 
System FFFFFFFF.86970000 FFFFFFFF. 86958000 FFFFFFFF.8696FFCO 

Register Stack: 

Stack Stack Base Stack Limit Stack Pointer Notes 
Kernel 00000000.7FF12000 00000000.7FF2A000 00000000.7FF12250 Current 
Executive 00000000.7FF46000  00000000.7FF56000  00000000.7FF46000 
Supervisor 00000000.7FF6A000 00000000.7FF8A000  00000000.7FF6A000 
User 000007FD.BFF3C000 0Q00007FD.BFF54000 000007FD.BFF3C160 #KPstack 
User 000007FD.BFF58000 000007FD.BFF70000 000007FD.BFF58108 KPstack 
User 000007FD.C0000000 000007FD.C0002000 000007FD.C0000268 
System FFFFF802.0F236000 FFFFF802.0F24E000 FFFFF802.0F236278 
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SHOW SUMMARY 


Format 


Parameters 


Qualifiers 


Description 


Displays a list of all active processes and the values of the parameters used in 
swapping and scheduling these processes. 


SHOW SUMMARY [/IMAGE|/PROCESS_NAME=process_name 
|/THREAD |/USER=username] 


None. 


[IMAGE 
Causes SDA to display, if possible, the name of the image being executed within 
each process. 


/PROCESS_NAME=process_name 

Displays only processes with the specified process name. You can use wildcards 
in process_name, in which case SDA displays all matching processes. The default 
action is for SDA to display data for all processes, regardless of process name. 


/THREAD 
Displays information on all the current threads associated with the current 
process. 


/USER=username 

Displays only the processes of the specified user. You can use wildcards in 
username, in which case SDA displays processes of all matching users. The 
default action is for SDA to display data for all processes, regardless of user 
name. 


The SHOW SUMMARY command displays the information in Table 4—29 for each 
active process in the system. 


Table 4-29 Process Information in the SHOW SUMMARY Display 


Column Contents 


Extended PID The 32-bit number that uniquely identifies the process or 
thread. 
Indx Index of this process into the PCB array. When SHOW 


SUMMARY/THREAD is used, for all threads of a process 
other than the initial thread, displays the thread number. 


1 


Process name Name assigned to the process. 


1When SHOW SUMMARY/THREAD is used, this column is blank for all threads other than the initial 
thread. 


(continued on next page) 
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Table 4—29 (Cont.) Process Information in the SHOW SUMMARY Display 


Column Contents 
1 


Username Name of the user who created the process. 


State Current state of the process. Table 4-30 shows the 14 states 
and their meanings. 


Pri Current scheduling priority of the process. 

PCB/KTB Address of the process control block or address of the kernel 
thread block. 

PHD! Address of the process header. 

Wkset! Number (in decimal) of pages currently in the process 


working set. 


1When SHOW SUMMARY/THREAD is used, this column is blank for all threads other than the initial 
thread. 


Table 4-30 Current State Information 


State Meaning 

COM Computable and resident in memory 

COMO Computable, but outswapped 

CUR nn Currently executing on CPU ID nn 

CEF Waiting for a common event flag 

LEF Waiting for a local event flag 

LEFO Outswapped and waiting for a local event flag 

HIB Hibernating 

HIBO Hibernating and outswapped 

SUSP Suspended 

SUSPO Suspended and outswapped 

PFW Waiting for a page that is not in memory (page-fault wait) 
FPG Waiting to add a page to its working set (free-page wait) 
COLPG Waiting for a page collision to be resolved (collided-page wait); 


this usually occurs when several processes cause page faults on 
the same shared page 


MWAIT Miscellaneous wait 

RWxxx! Waiting for system resource xxx 

TBS! Waiting "To Be Scheduled" by class scheduler 
TBSO! Waiting "To Be Scheduled" and outswapped 
TBS_P! "To Be Scheduled" state is pending 

TBSPO! "To Be Scheduled" state is pending and outswapped 
WTBYT! Waiting for BYTCNT quota 

WTTQE! Waiting for TQCNT quota 


1These states represent additional interpretation by SDA of one of the 14 scheduler states. 
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SDA> SHOW SUMMARY 
Current process summary 


State 


Pri 


PCB/KTB 


PHD 


SDA Commands 
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Se DTD ee Jee s: eee esas a tas eeees case G eeeesS Gas Seer ses seeeekes cele 


00000041 
00000045 
00000046 
00000047 
00000048 
00000049 
0000004A 
0000004B 
0000004C 
0000004D 
0000004E 
00000050 
00000051 
00000052 


0001 
0005 
0006 
0007 
0008 
0009 
000A 
000B 
000C 
000D 
000E 
0010 
0011 
0012 


Process name Username 
SWAPPER 

IPCACP SYSTEM 
ERRFMT SYSTEM 
OPCOM SYSTEM 
AUDIT SERVER AUDITSSERVER 
JOB CONTROL SYSTEM 
SECURITY SERVER SYSTEM 
TP SERVER SYSTEM 
NETACP DECNET 
EVL DECNET 
REMACP SYSTEM 
DECWSSERVER 0 SYSTEM 


DECWSLOGINOUT <login> 
SYSTEM SYSTEM 


80C641D0 
80DC0780 
80DC2240 
80DC3340 
80D61280 
80D620C0 
80DC58C0 
80DC8900 
80DBFE00 
80DCA080 
80DE4E00 
80DEF940 
80DFOF00 
80D772C0 


80C63E00 
81266000 
8126C000 
81272000 
81278000 
8127000 
81284000 
8128A000 
8125A000 
81290000 
81296000 
812A2000 
812A8000 
81260000 


The SHOW SUMMARY command describes all active processes in the system at 
the time of the system failure. Note that there was no process in the CUR state 


at the time of the failure. 
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SHOW SWIS 


This command is for 164 only. Displays the SWIS (SoftWare Interrupt Services) 
data structure, which includes a ring buffer. 


Format 
SHOW SWIS_ [/RING_BUFFER [/CPU=n]] 


Qualifiers 


/CPU=n 
When used with /RING_BUFFER, displays only the entries for the specified CPU. 


/RING_BUFFER 
Displays the SWIS log or ring buffer. 


Description 


The SHOW SWIS command without the /RING_BUFFER qualifier displays 

the addresses of the SWIS data structure for each CPU. SHOW SWIS/RING_ 
BUFFER displays the SWIS ring buffer (also known as the SWIS log), most 
recent entry first, and assigns meaning to some values, for example, trap type, 
system service invoked. For best results, use READ/EXEC or READ/IMAGE 
SYS$PUBLIC_VECTORS first so that the system service codes are recognized. If 
you specify /CPU=n, only the records for that CPU are displayed. 
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Example 


SDA> read/exec 

SDA> read/exec/nolog 

SDA> define ssentry 8692B8F0 
SDA> define intstk 8692B9F0 
SDA> show swis/ring buffer 


SWIS ring buffer for all CPUs 


Clock Data 1 Data 2 Data 3 CPU Ident x** See below. *** 
2CEDAD3C 82D66400a 83814080 FFFFFFFF.86B04000 00 SWPCXout 
2CEDA929 82D66400a 83814080 FFFFF802.0EE370A8 00 SWPCTXin 
2CED9F16 0000001F 0000001F FFFFFFFF.8046C270a 00 RaisIPL 
2CED928F 8692B8F0a 00000000 FFFFFFFF.8046B760b 00 SSSwRet 
2CED8FED 8692B8E0 00000000 0000002C.DC0351F2 00 RetKSrvc 
2CED8B2E 8692B8F0a 06900660b FFFFFFFF.8046B760c 00 EntKSrvc 

EntKSrve 
2CED72C1 8692B9F0a 00000000 FFFFFFFF.8692BFC0b 00 ExcpDsp2 
2CED70B4 8692B9F0a 00000041b FFFFFFFF.80322F50c 00 ExcpDisp 

ExcpDisp 
2CED6E84 00000001 00000000 00000000.0001001Fa 00 GetDpth 
2CED6822 00000016 0000001F FFFFFFFF.80322EB0a 00 RSetIPL 
2CED62F0 8692BCF0a 00000003 FFFFFFFF.8066C000b 00 IPDisp 


Symbolized value ‘a’ Symbolized value 'b’ & ‘c’ 


BUG$GQ_HWPCB 

BUG$GQ_HWPCB 

EXESBUGCHECK SWAPPED _C+000E0 

SSENTRY ° ~ EXE$BUGCHECK CONTINUE_C+003C0 


SSENTRY SYS$RPCC_64 C 

EXESBUGCHECK CONTINUE C+003C0 
INTSTK INTSTK+005D > 
INTSTK Bugcheck Breakpoint Trap 

SYSTEM SYNCHRONIZATION MIN+42F50 
LNMSC DEL OVERLAY+0001B ~ ~ 
SYSTEM SYNCHRONIZATION MIN+42EB0 
INTSTK+00300 ~ SCHSIDLE_C+00290 


The SHOW SWIS example displays the most recent entries in the SWIS log at 
the time of a system crash. Note the a, b, c alongside the data values. These 

indicate which column contains the symbolization for the value. ‘a’ is always 
in the first column; ‘b’ is in the second column, and ’c’ is also in the second 

column on the next line. If some or all data values cannot be symbolized, the 

columns are left blank or there is no continuation line. 
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SHOW SYMBOL 


Format 


Parameter 


Qualifiers 


Description 


Displays the hexadecimal value of a symbol and, if the value is equal to an 
address location, the contents of that location. 


SHOW SYMBOL _ [/ALL [/ALPHAI/VALUE]] symbol-name 


symbol-name 
Name of the symbol to be displayed. You must provide a symbol-name unless 
you specify the /ALL qualifier. 


/ALL 
Displays information on all symbols whose names begin with the characters 
specified in symbol-name. If no symbol name is given, all symbols are displayed. 


/ALPHA 

When used with the /ALL qualifier, displays the symbols sorted only in 
alphabetical order. The default is to display the symbols twice, sorted 
alphabetically and then by value. 


When used with a wildcard symbol name, displays the symbols in alphabetical 
order. This is the default action. 


NVALUE 

When used with the /ALL qualifier, displays the symbols sorted only in value 
order. The default is to display the symbols twice, sorted alphabetically and then 
by value. 


When used with a wildcard symbol name, displays the symbols in value order. 


The SHOW SYMBOL command with the /ALL qualifier outputs all symbols 
whose names begin with the characters specified in symbol-name in both 
alphabetical order and in value order. If no symbol-name is given, all symbols 
are output. 


The SHOW SYMBOL/ALL command is useful for determining the values of 
symbols that belong to a symbol set, as illustrated in the second example below. 


The SHOW SYMBOL command without the /ALL qualifier allows for standard 
wildcards in the symbol-name parameter. By default, matching symbols are 
displayed only in alphabetical order. If you specify SHOW SYMBOL/VALUE, 
then matching symbols are output sorted by value. If you specify SHOW 
SYMBOL/ALPHA/VALUE, then matching symbols are displayed twice, sorted 
alphabetically and then by value. 


The SHOW SYMBOL command without the /ALL qualifier and no wildcards in 
the symbol-name parameter outputs the value associated with the given symbol. 
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SDA Commands 
SHOW SYMBOL 


When displaying any symbol value, SDA also treats the value as an address and 
attempts to obtain the contents of the location. If successful, the contents are also 
displayed. 


1. SDA> SHOW SYMBOL G 
G = FFFFFFFF.80000000 : 6BFA8001.201F0104 


The SHOW SYMBOL command evaluates the symbol G as 
FFFFFFFF.80000000 1g and displays the contents of address 
FFFFFFFF.80000000 1g as 6BFA8001.201F0104.¢. 


2. SDA> SHOW SYMBOL/ALL BUG 
Symbols sorted by name 
BUGS$L BUGCHK FLAGS 
BUGSL FATAL SPSAV 
BUGSREBOOT _ 

BUG$REBOOT_C 


FFFFFFFF.804031E8 : 00000000.00000001 
FFFFFFFF.804031F0 : 00000000.00000001 
FFFFFFFF.8042E320 : 00000000.00001808 
FFFFFFFF.8004F4D0 : 47FB041D.47FD0600 


Symbols sorted by value 
BUGSREBOOT_C 
BUG$L_BUGCHK FLAGS 
BUG$L_FATAL SPSAV 
BUGSREBOOT 


FFFFFFFF.8004F4D0 :47FB041D.47FD0600 
FFFFFFFF.804031E8 :00000000.00000001 
FFFFFFFF.804031F0 :00000000.00000001 
FFFFFFFF.8042E320 :00000000.00001808 


This example shows the display produced by the SHOW SYMBOL/ALL 
command. SDA searches its symbol table for all symbols that begin with the 
string “BUG” and displays the symbols and their values. Although certain 
values equate to memory addresses, it is doubtful that the contents of those 
addresses are actually relevant to the symbol definitions in this instance. 
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SHOW TQE 


Displays the entries in the timer queue. The default output is a summary display 
of all timer queue entries (TQEs) in chronological order. 


Format 


SHOW TQE_ [/ADDRESS=nl[/ALL][/BACKLINK][/PID=n] 
[/ROUTINE=n] 


Parameters 


None. 


Qualifiers 


/ADDRESS=n 
Outputs a detailed display of the TQE at the specified address. 


/ALL 
Outputs a detailed display of all TQEs. 


/BACKLINK 
Outputs the display of TQEs, either detailed (/ALL) or brief (default), in reverse 
order, starting at the entry furthest into the future. 


/PID=n 

Limits the display to the TQEs that affect the process with the specified internal 
PID. The PID format required is the entire internal PID, including both the 
process index and the sequence number, and not the extended PID or process 
index alone, as used elsewhere in SDA. You can also display TQEs specific to a 
process using SHOW PROCESS/TQE. 


/ROUTINE=n 
Limits the display to the TQEs for which the specified address is the fork PC. 


Description 


The SHOW TQE command allows the timer queue to be displayed. By default a 
summary display of all TQEs is output in chronological order, beginning with the 
next entry to become current. 


The /ADDRESS, /PID, and /ROUTINE qualifiers are mutually exclusive. The 
/ADDRESS and /BACKLINK qualifiers are mutually exclusive. 
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In the summary display, the TQE type is given as a six-character code, as in 
Table 4-31. 


Table 4-31 TQE Types in Summary TQE Display 


Column Symbol Meaning 


1 T Timer ($SETIMR) entry 

S) System subroutine entry 

W Scheduled wakeup ($SCHDWK) entry 
2 Ss Single-shot entry 

R Repeated entry 
3 D Delta time 

A Absolute time 
4 C CPU time 

Elapsed time 

5 E Extended format (64-bit TQE) 

- 32-bit TQE 
6 N TQE not to be deallocated at AST completion 


- TQE to be deallocated at AST completion 


Examples 


1. 


815AB8C0 
812CB3C0 
81514140 
815C8040 
8148CF98 
81318290 
814FB080 
8140FF40 


81503100 
815030C0 


SDA> SHOW TOE 


Timer queue entries 


System time: 15-NOV-2001 15:09:06.92 
First TQE time: 15-NOV-2001 15:09:06.92 


PID/ 

Expiration Time Type routine 
QOA0516F.EF279BOF 15-NOV-2001 15:09:06.92 SSD--- 835FCC48 TCPIPSINTERNET SERVICES+9EC48 
QOA0516F.EF279BOF 15-NOV-2001 15:09:06.92 SRD--- 812CCEC8 SYS$PPPDRIVER+0EEC8 
QOA0516F.EF29FD5F 15-NOV-2001 15:09:06.94 TSD--- 0001000F §SECUURITY_SERVER 
Q0A0516F.EF2B2E87 15-NOV-2001 15:09:06.95 SRD--- 81361BA0 SYSSLTDRIVER+31BA0 
QOA0516F.EF2C52AD 15-NOV-2001 15:09:06.95 SRD--- 812786B0 LANSCREATE LAN+000B0 
QOA0516F.EF2FDC84 15-NOV-2001 15:09:06.98 SRD--- 813187B8 PWIPDRIVER+047B8 
Q00A0516F.EF3238D0 15-NOV-2001 15:09:06.99 TSD--- 0001000F SECURITY SERVER 
QOA0516F.EF32851A 15-NOV-2001 15:09:06.99 TSD--- 0001000F SECURITY SERVER 
00A05177.0AED8000 15-NOV-2001 16:00:00.00 TSA--- 0001000C JOB CONTROL 
00A0C160.63CD14D9 7-APR-2002 02:00:00.91 TSA--- 0001000C JOB CONTROL 


This example shows the summary display of all TQEs. 
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2. SDA> SHOW TQE/ADDRESS=8131F5C0 


Timer queue entry 8131F5C0 


TQE Address: 
FLink: 
Requestor process ID: 


Expiration time: 
Delta repeat time: 


Fork PC: 
Fork R3: 
Fork R4: 


009EADD2. 
00000000. 


00000000. 
FFFFFFFF. 


8131F5C0 
8129C6D8 
00000000 


417463F4 
00989680 


811FDCD0 
00000000 
8131DB00 


Type: 
BLink: 
Access Mode: 


30-MAY-2000 15:14:47.31 
0 00:00:01.00 


NETDRIVER+190D0 


00000005 SYSTEM SUBROUTINE REPEAT 
83975948 
00000000 


+67860 


This example shows the detailed display for a single TQE. 
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SHOW TQEIDX 


Format 


Parameter 


Qualifiers 


Description 


Examples 


Displays the contents of the timer queue entry index (TQEIDX) structures. 


SHOW TQEIDX [/ADDRESS=address1/ALL ] 


None. 


/ADDRESS=address 
Causes SDA to output a detailed display of the contents of the TQEIDX at the 
specified address. 


/ALL 
Causes SDA to output a detailed display of the contents of all TQEIDX structures. 


The SHOW TQEIDX comand allows the timer queue entry index structures to 
be displayed. The default display is a summary of all TQEIDX structures. The 
/ADDRESS and /ALL qualifiers are mutually exclusive. 


1. SDA> show tqeidx 


Timer queue index buckets 


TOQEIDX 


Free 


address Level Parent count Maximum key 


872B6700 00000001 00000000 0000003C FFFFFFFF .FFFFFFFF 
875ED640 00000000 872B6700 00000005 00A39404.827C01CF 
87312E80 00000000 872B6700 00000032 00A39A11.9DABF957 
8726A300 00000000 872B6700 0000003D FFFFFFFF .FFFFFFFF 


Time index overflow list is empty 


ID index buckets 


TOQEIDX 


address Level Parent count Maximum key 


872AF900 00000001 00000000 0000003D FFFFFFFF .FFFFFFFF 
86C29C80 00000000 872AF900 00000016 0002C000.83374030 
872FD780 00000000 872AF900 0000001F FFFFFFFF.FFFFFFFF 


ID index overflow list is empty 


This example shows the summary TQEIDX display. 
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SHOW UNWIND 


Format 


Parameter 


Qualifier 


Description 


Examples 


This command is for 164 only. Displays the master unwind table for system space 
(default). 


SHOW UNWIND [address 1 [/ALL ]] 


address 
Address of the PC whose unwind data is to be displayed. 


/ALL 
Displays the details of every system unwind descriptor. 


Displays the master unwind table for system space. This is the default. If /ALL 
is given, the details of every system unwind desriptor are displayed. If an address 
is given, the unwind descriptor for the program counter (PC) (IIP) is located and 
displayed. The address can be in system space or process space. 


Also see SHOW PROCESS/UNWIND. 


1. SDA> show unwind 


System Unwind Table 


Page Header VA Entries Region ID 

FFFFFFFF.7FFFC000  00000000.00000018 00000000.00000000 

FFFFFFFF.7FFFA000  00000000.00000018 00000000.00000000 

FFFFFFFF.7FFF8000  00000000.00000018 00000000.00000000 

FFFFFFFF.7FF44000  00000000.00000018 00000000.00000000 

FFFFFFFF.7F7A0000  00000000.00000018 00000000.00000000 

FFFFFFFF.7F56C000  00000000.00000006 00000000.00000000 

Image name Code Base VA UT Base VA Unwind Info Base Flags 

MUTE VA Mode Code End VA UT Size GP 

EXCEPTION MON FFFFFFFF.80480000 FFFFFFFF.82D53800 FFFFFFFF.82D53800 
FFFFFFFF.7FFFC020 00000000 FFFFFFFF.8055CDCF 00000000.00002AD8 FFFFFFFF.82F6F400 

EXCEPTION MON FFFFFFFF.86AB0000 FFFFFFFF.86AB4000 FFFFFFFF.86AB4000 Obsolete 
FFFFFFFF.7FFFC170 00000000 FFFFFFFF.86AB207F 00000000.00000060 FFFFFFFF.82F6F400 

IO ROUTINES MON FFFFFFFF.80560000 FFFFFFFF.82D78600 FFFFFFFF.82D78600 
FFFFFFFF.7FFFC2CO 00000000 FFFFFFFF.8064A7AF 00000000.00004B00 FFFFFFFF.82FA2800 

IO_ ROUTINES MON FFFFFFFF.86AB6000 FFFFFFFF.86AB8000 FFFFFFFF.86AB8000 Obsolete 
FFFFFFFF.7FFFC410 00000000 FFFFFFFF.86AB73AF 00000000.000000A8 FFFFFFFF.82FA2800 

SYSDEVICE FFFFFFFF.80650000 FFFFFFFF.82DA7A00 FFFFFFFF.82DA7A00 
FFFFFFFF.7FFFC560 00000000 FFFFFFFF.8065E90F 00000000.00000240 FFFFFFFF.82FA9400 
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This example shows the master unwind table for the system, the pages that 
are being read and the images whose unwind data is present. 


2. SDA> show unwind 00000000.00020130 
Unwind Table Entry for 00000000.00020130 


Image name: X 


MUTE VA: 000007FD.BFFC62C0 Mode: 00000001 
Code Base VA: 00000000.00020000 Code End VA: 00000000.000201FF 
UT Base VA: 00000000.00030000 UT Size: 00000000.00000030 
Unwind Info Base:  00000000.00030000 GP: 00000000.00240000 
Flags: 0000 


Unwind Descriptor: 00000000.00030090 PC range = 00000000.00020130:00000000.000201DF 


Unwind Descriptor flags: No handler present, No OSSD present 


Unwind descriptor records: Rl Region Header: Short Prologue, PC range = 00000000.00020130:00000000.00020131 


Rl 


Rl 


P7: MEM STACK V PC=00000000.00020131 


P3: PSP GR R41 
P3: PFS GR R40 


Region Header: Short Body, PC range = 00000000.00020132:00000000.000201B0 
Bl: Short Label State LABEL=00000001 
B2: Short Epilogue ECOUNT=00000000 PC=00000000.000201A0 


Region Header: Short Body, PC range = 00000000.000201B1:00000000.000201D1 
Bl: Short Copy State LABEL=00000001 


This example shows the unwind data for PC 20130, giving image name, 
location of unwind data and all unwind descriptors. For an explanation of the 
unwind descriptors, see the HP OpenVMS Calling Standard, Appendices A 


and B. 
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SHOW WORKING_SET_LIST 


Displays the system working set list without changing the current process 


context. 


Format 


SHOW WORKING_SET_LIST or SHOW WSL [={GPT|SYSTEM|LOCKED | n}] 


Format 


SHOW WSL 


Parameters 


None. 


Qualifiers 


None. 


Description 


[={GPT | SYSTEM|ILOCKED | n}] 


The SHOW WORKING_SET_LIST command displays the contents of requested 
entries in the system working set list. If you do not specify an option, all working 
set list entries are displayed. Table 4-32 shows the options available with 
SHOW WORKING_SET_LIST. The SHOW WORKING_SET_LIST command is 
equivalent to the SHOW PROCESS/SYSTEM/WORKING_SET_LIST command, 
but the SDA current process context returns to the prior process upon completion. 
See the SHOW PROCESS command and Table 4—20 for more information. 


Table 4-32 Options for the SHOW WORKING_SET_LIST Command 


Options 


Results 


GPT 
SYSTEM 
LOCKED 


Displays only working set list entries for global page table pages 
Displays only working set list entries for pageable system pages 
Displays only working set list entries for pageable system pages 
that are locked in the system working set 


Displays a specific working set entry, where n is the working set 
list index (WSLX) of the entry of interest 


4-244 SDA Commands 


SDA Commands 
SHOW WSL 


SHOW WSL 


See SHOW WORKING_SET_LIST. 


SDA Commands 4-245 


SDA Commands 


SPAWN 

SPAWN 
Creates a subprocess of the process currently running SDA, copying the context 
of the current process to the subprocess and, optionally, executing a specified 
command within the subprocess. 

Format 
SPAWN __[/qualifier[,...]] [command] 

Parameter 
command 
Name of the command that you want the subprocess to execute. 

Qualifiers 


AINPUT=filespec 

Specifies an input file containing one or more command strings to be executed 

by the spawned subprocess. If you specify a command string with an input file, 
the command string is processed before the commands in the input file. When 

processing is complete, the subprocess is terminated. 


/NOLOGICAL_NAMES 

Specifies that the logical names of the parent process are not to be copied to the 
subprocess. The default behavior is that the logical names of the parent process 
are copied to the subprocess. 


/NOSYMBOLS 

Specifies that the DCL global and local symbols of the parent process are not 
to be passed to the subprocess. The default behavior is that these symbols are 
passed to the subprocess. 


/NOTIFY 

Specifies that a message is to be broadcast to SYS$OUTPUT when the subprocess 
either completes processing or aborts. The default behavior is that such a 
message is not sent to SYS$OUTPUT. 


/NOWAIT 

Specifies that the system is not to wait until the subprocess is completed before 
allowing more commands to be entered. This qualifier allows you to input 

new SDA commands while the spawned subprocess is running. If you specify 
/NOWAIT, use /OUTPUT to direct the output of the subprocess to a file to prevent 
more than one process from simultaneously using your terminal. 


The default behavior is that the system waits until the subprocess is completed 
before allowing more SDA commands to be entered. 


/OUTPUT=filespec 

Specifies an output file to which the results of the SPAWN operation are written. 
To prevent output from the spawned subprocess from being displayed while 

you are specifying new commands, specify an output other than SYS$OUTPUT 
whenever you specify /NOWAIT. If you omit the /OUTPUT qualifier, output is 
written to the current SYS$OUTPUT device. 
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SPAWN 


/PROCESS=process-name 

Specifies the name of the subprocess to be created. The default name of the 
subprocess is USERNAME_n, where USERNAME is the user name of the parent 
process. The variable n represents the subprocess number. 


SDA> SPAWN 
$ MAIL 
$ DIR 
$ LO 
Process SYSTEM_1 logged out at 5-JAN-1993 15:42:23.59 
SDA> 


This example uses the SPAWN command to create a subprocess that issues DCL 
commands to invoke the Mail utility. The subprocess then lists the contents of a 
directory before logging out to return to the parent process executing SDA. 
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UNDEFINE 


Removes the specified symbol from SDA’s symbol table. 


Format 
UNDEFINE — symbol 
Parameter 
symbol 
The name of the symbol to be deleted from SDA’s symbol table. A symbol name is 
required. 
Qualifiers 
None. 
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VALIDATE PFN_LIST 


Format 


Parameters 


Qualifiers 


Description 


Examples 


Validates that the page counts on lists are correct. 


VALIDATE PFN_LIST {/ALL (d)1[/BAD|/FREE|/MODIFIED |/PRIVATE | 
/UNTESTED |/ZERO}} 


None. 


/ALL 
Validates all the PFN lists: bad, free, modified, zeroed free pages, and private 


pages. 


/BAD 
Validates the bad page list. 


/FREE 
Validates the free page list. 


/MODIFIED 
Validates the modified page list. 


/PRIVATE 
Validates all private page lists. 


/UNTESTED 
Validates the untested page list that was set up for deferred memory testing. 


/ZERO 
Validates the zeroed free page list. 


The VALIDATE PFN_LIST command validates the specified PFN list by counting 
the number of entries in the list and comparing that to the running count of 
entries for each list maintained by the system. 


1. SDA> VALIDATE PFN LIST 
Free page list validated: 1433 pages 
(excluding zeroed free page list with expected size 103 pages) 
Zeroed free page list validated: 103 pages 
Modified page list validated: 55 pages 
Bad page list validated: 0 pages 
Untested page list validated: 0 pages 
Private page list at 81486340 validated: 2 pages 


This example shows the default behavior of VALIDATE PFN_LIST, checking 
all lists. 
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2. SDA> VALIDATE PFN LIST/FREE 
Free page list validated: 1433 pages 
(excluding zeroed free page list with expected size 103 pages) 


This example shows the validation of only the free list. 
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VALIDATE QUEUE 


Format 


Parameter 


Qualifiers 


Validates the integrity of the specified queue by checking the pointers in the 
queue. 


VALIDATE QUEUE [address] 
[/BACKLINKI/LIST |/PHYSICAL | 
/QUADWORD |/SELF_RELATIVE |/SINGLY_LINKED] 


address 
Address of an element in a queue. 


If you specify the period (.) as the address, SDA uses the last evaluated 
expression as the queue element’s address. 


If you do not specify an address, the VALIDATE QUEUE command determines 
the address from the last issued VALIDATE QUEUE command in the current 
SDA session. 


If you do not specify an address, and no queue has previously been specified, 
SDA displays the following error message: 


%SDA-E-NOQUEUE, no queue has been specified for validation 


/BACKLINK 

Allows doubly linked lists to be validated from the tail of the queue. If the queue 
is found to be broken when validated from the head of the queue, you can use 
/BACKLINK to narrow the list of corrupted entries. 


/LIST 
Displays the address of each element in the queue. 


/PHYSICAL 
Allows validation of queues whose header and links are physical addresses. 


/QUADWORD 
Allows the validate operation to occur on queues with linked lists of quadword 
addresses. 


/SELF_RELATIVE 
Specifies that the selected queue is a self-relative queue. 


/SINGLY_LINKED 
Allows validation of queues that have no backward pointers. 
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Description 


Examples 


The VALIDATE QUEUE command uses the forward and, optionally, backward 
pointers in each element of the queue to make sure that all such pointers are 
valid and that the integrity of the queue is intact. If the queue is intact, SDA 
displays the following message: 


Queue is complete, total of n elements in the queue 


In these messages, n represents the number of entries the VALIDATE QUEUE 
command has found in the queue. 


If SDA discovers an error in the queue, it displays one of the following error 
messages: 

Error in forward queue linkage at address nnnnnnnn after tracing x elements 
Error comparing backward link to previous structure address (nnnnnnnn) 

Error occurred in queue element at address ooooo0o00 after tracing pppp elements 
These messages can appear frequently when you use the VALIDATE QUEUE 
command within an SDA session that is analyzing a running system. In a 
running system, the composition of a queue can change while the command is 
tracing its links, thus producing an error message. 


If there are no entries in the queue, SDA displays this message: 


The queue is empty 


1. SDA> VALIDATE QUEUE/SELF RELATIVE I0c$GQ POSTIOQ 
Queue is complete, total of 159 elements in the queue 


This example validates the self-relative queue IOC$GQ_POSTIQ. The 
validation is successful and the system determines that there are 159 IRPs in 
the list. 


2. SDA> VALIDATE QUEUE/QUADWORD FFFFFFFF80D0E6CO/LIST 


Entry Address Flink Blink 

Header FFFFFFFF80D0E6CO FFFFFFFF80D03780 FFFFFFFF80D0E800 
l. FFFFFFFF80D0E790 FFFFFFFF80D0E7CO FFFFFFFF80D0E6C0 
2. FFFFFFFF80D0E800 FFFFFFFF80D0E6C0 FFFFFFFF80D0E7C0 


Queue is complete, total of 3 elements in the queue 


This example shows the validation of quadword elements in a list. 


3. SDA> VALIDATE QUEUE/SINGLY_ LINKED EXE$GL_NONPAGED+4 
Queue is zero-terminated, total of 95 elements in the queue 


This example shows the validation of singly linked elements in the queue. 
The forward link of the final element is zero instead of being a pointer back 
to the queue header. 
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VALIDATE SHM_CPP 


Format 


Parameters 


Qualifiers 


Validates all the shared memory common property partitions (CPPs) and the 
counts and ranges of attached PFNs; optionally, it can validate the contents of the 
database for each PFN. 


VALIDATE SHM_CPP_ [/QUALIFIERS] 


None. 


/ADDRESS=n 
Validates the counts and ranges for a single shared memory CPP given the 
address of the SHM_CPP structure. 


/ALL 
Validates all the shared memory CPPs. This is the default. 


AIDENT=n 
Validates the counts and ranges for a single shared memory CPP. 


/PFN 
Validates the PFN database contents for each attached PFN. The default is all 


lists (free, bad, untested) plus the PFN database pages and the complete range of 
PFNs in the CPP. 


To validate only the complete range of PFNs in the CPP, use the keyword ALL_ 
FRAGMENTS with the /PFN qualifier: 


/PEN = ALL FRAGMENTS 
To validate only the bad page list, use the keyword BAD with the /PFN qualifier: 


/PFN = BAD 
To validate only the free page list, use the keyword FREE with the /PFN qualifier: 
/PFN = FREE 


To validate the PFNs containing the PFN database, use the keyword PFNDB 
with the /PFN qualifier: 


/PFN = PFNDB 


To validate only the untested page list, use the keyword UNTESTED with the 
/PFN qualifier: 


/PEFN = UNTESTED 


To validate multiple lists, you can combine keywords for use with the /PFN 
qualifier: 


/PFN = (x,y) 


If you specify the /PFN without /ALL, /IDENT, or /ADDRESS, then the system 
validates the PFN lists from the last shared memory CPP. 
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Example 

SDA> VALIDATE SHM_CPP 

Not validating SHM_CPP 0000 at FFFFFFFF.7F2BA140, VALID flag clear 
Not validating SHM_CPP 0001 at FFFFFFFF.7F2BA380, VALID flag clear 
Not validating SHM_CPP 0002 at FFFFFFFF.7F2BA5C0, VALID flag clear 
Validating SHM_CPP 0003 at FFFFFFFF.7F2BA800 ... 


Validating counts and ranges in the free page list ... 
. oO.k, 


Not validating the bad page list, list is empty 

Not validating the untested page list, list is empty 
Not validating SHM_CPP 0004 at FFFFFFFF.7F2BAA40, VALID flag clear 
Not validating SHM_CPP 0005 at FFFFFFFF.7F2BAC80, VALID flag clear 
Not validating SHM_CPP 0006 at FFFFFFFF.7F2BAEC0, VALID flag clear 


This example shows the default output for the VALIDATE SHM_CPP command. 
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VALIDATE TQEIDX 


Format 


Parameters 


Qualifiers 


Description 


Example 


Validates all the data structures associated with timer queue entry index 
(TQEIDX) structures. 


VALIDATE TQEIDX 


None. 


None. 


TQEs are linked together with index blocks that point to TQEs or to another level 
of index block. VALIDATE TQEIDX checks that all the index blocks are correctly 
linked together. 


SDA> VALIDATE TQEIDX 

Validating time index buckets... 
wae Oeke 

Validating ID index buckets... 
sme Oaks 

Validating lst time... 
wee OK, 

Validating counts... 

. o.k. 


This example shows the output from a successful VALIDATE TQEIDX command. 
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WAIT 
WAIT 
Causes SDA to wait for the specified length of time. 
Format 
WAIT _ [wait-time] 
Parameters 
wait-time 
The wait time is given as a delta time: [[hh:|mm:]ss[.t[h]]. If omitted, the default 
wait time is one second. 
Qualifiers 


None. 


Description 


The WAIT command can be used in command procedures such as scripts 
collecting performance data. See Chapter 8 for a sample procedure. 


Example 


SDA> WAIT 00:00:15 


SDA waits 15 seconds before accepting the next command. 
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This chapter presents an overview of the SDA CLUE (Crash Log Utility 
Extractor) extension commands, how to display information using these 
commands, and how to use SDA CLUE with DOSD. This chapter also describes 
the SDA CLUE commands. 


5.1 Overview of SDA CLUE Extensions 


SDA CLUE (Crash Log Utility Extractor) commands automate the analysis of 
crash dumps and maintain a history of all fatal bugchecks on either a standalone 
or cluster system. You can use SDA CLUE commands in conjunction with SDA to 
collect and decode additional dump file information not readily accessible through 
standard SDA commands. SDA CLUE extension commands can summarize 
information provided by certain standard SDA commands and provide additional 
detail for some SDA commands. For example, SDA CLUE extension commands 
can quickly provide detailed extended QIO processor (XQP) summaries. You can 
also use SDA CLUE commands interactively on a running system to help identify 
performance problems. 


You can use all CLUE commands when analyzing crash dumps; the only CLUE 
commands that are not allowed when analyzing a running system are CLUE 
CRASH, CLUE ERRLOG, CLUE HISTORY, and CLUE STACK. 


When you reboot the system after a system failure, you automatically invoke 
SDA by default. To facilitate better crash dump analysis, SDA CLUE commands 
automatically capture and archive summary dump file information in a CLUE 
listing file. 


A startup command procedure initiates commands that do the following: 
e Invoke SDA 

e Issue an SDA CLUE HISTORY command 

e Create a listing file called CLUE$nodename_ddmmyy_hhmm.LIS 


The CLUE HISTORY command adds a one-line summary entry to a history file 
and saves the following output from SDA CLUE commands in the listing file: 


e Crash dump summary information 
e System configuration 
e Stack decoder 


e Page and swap files 
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e Memory management statistics 
e Process DCL recall buffer 

e Active XQP processes 

e XQP cache header 


The contents of this CLUE list file can help you analyze a system failure. If these 
files accumulate more space than the threshold allows (default is 5000 blocks), 
the oldest files are deleted until the threshold limit is reached. You can also 
customize this threshold using the CLUE$MAX_BLOCKS logical name. 


For additional information on the contents of the CLUE listing file, see the 
reference section on CLUE HISTORY. 


It is important to remember that CLUE$nodename_ddmmyy_hhmm.LIS contains 
only an overview of the crash dump and does not always contain enough 
information to determine the cause of the crash. The dump itself should always 
be saved using the procedures described in Section 2.2.2 and Section 2.2.3. 


To inhibit the running of CLUE at system startup, define the logical 
CLUE$INHIBIT in the SYLOGICALS.COM file as /SYS TRUE. 


5.2 Displaying Data with CLUE 


To invoke a CLUE command, enter the command at the SDA prompt. For 
example: 


SDA> CLUE CONFIG 


5.3 Using CLUE with DOSD 


DOSD (Dump Off System Disk) allows you to write the system dump file to a 
device other than the system disk. For SDA CLUE to be able to correctly find the 
dump file to be analyzed after a system crash, you need to perform the following 
steps: 


1. Modify the command procedure SYSSMANAGER:SYCONFIG.COM to add the 
system logical name CLUE$DOSD_DEVICE to point to the device where the 
dump file resides. You need to supply only the physical or logical device name 
without a file specification. 


2. Modify the command procedure SYS$MANAGER:SYCONFIG.COM to mount 
systemwide the device where the dump file resides. Otherwise, SDA CLUE 
cannot access and analyze the dump file. 


In the following example, the dump file has been placed on device $3$DUA25, 
which has the label DMP$DEV. You need to add the following commands to 
SYS$MANAGER:SYCONFIG.COM: 


$mount/system/noassist $3$dua25: dmp$dev dmp$dev 
$define/system clue$dosd_ device dmp$dev 
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5.4 SDA CLUE Extension Commands 


This section describes the following SDA CLUE extension commands: 


CLUE CALL_FRAME 
CLUE CLEANUP 
CLUE CONFIG 
CLUE CRASH 
CLUE ERRLOG 
CLUE FRU 
CLUE HISTORY 
CLUE MCHK 
CLUE MEMORY 
CLUE PROCESS 
CLUE REGISTER 
CLUE SG 

CLUE STACK 
CLUE SYSTEM 
CLUE VCC 

CLUE XQP 
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CLUE CALL_FRAME 


Format 


Parameters 


Qualifiers 


For Alpha only, displays key information, such as the PC of the caller, from the 
active call frames at time of the crash. 


CLUE CALL_FRAME_ [/CPU [cpu-id| ALL] 
|/PROCESS [/ADDRESS=n|! INDEX=n 
| /IDENTIFICATION=n| process-name | ALL]] 


ALL 

When used with /CPU, it requests information about all CPUs in the system. 
When used with /PROCESS, it requests information about all processes that exist 
in the system. 


cpu-id 

When used with /CPU, it gives the number of the CPU for which information is 
to be displayed. Use of the cpu-id parameter causes the CLUE CALL_FRAME 
command to perform an implicit SET CPU command, making the indicated CPU 
the current CPU for subsequent SDA commands. 


process-name 

When used with /PROCESS, it gives the name of the process for which 
information is to be displayed. Use of the process-name parameter, the 
/ADDRESS qualifier, the /INDEX qualifier, or the IDENTIFICATION qualifier 
causes the CLUE CALL_FRAME command to perform an implicit SET PROCESS 
command, making the indicated process the current process for subsequent SDA 
commands. You can determine the names of the processes in the system by 
issuing a SHOW SUMMARY command. 


The process-name can contain up to 15 letters and numerals, including the 
underscore (_) and dollar sign ($). If it contains any other characters, you must 
enclose the process-name in quotation marks (""). 


/ADDRESS=n 
Specifies the PCB address of the desired process when used with CLUE CALL_ 
FRAME/PROCESS. 


/CPU [cpu-id | ALL] 
Indicates that the call frame for a CPU is required. Specify the CPU by its 
number or use ALL to indicate all CPUs. 


ADENTIFICATION=n 
Specifies the identification of the desired process when used with CLUE CALL_ 
FRAME/PROCESS. 


ANDEX=n 
Specifies the index of the desired process when used with CLUE CALL_ 
FRAME/PROCESS. 
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/PROCESS [process-name | ALL] 

Indicates that the call frame for a process is required. The process should be 
specified with either one of the qualifiers /ADDRESS, /IDENTIFICATION, or 
/INDEX, or by its name, or by using ALL to indicate all processes. 


Description 


The CLUE CALL_FRAME command displays call chain information for a process 
or a CPU. The process context calls work on both the running system and dump 
file; the CPU context calls only on dump files. 


If neither /CPU nor /PROCESS is specified, the parameter (CPU-id or process- 
name) is ignored and the call frame for the SDA current process is displayed. 


Examples 


1. 


SDA>CLUE CALL/PROCESS IPCACP 
Call Chain: Process index: 000B Process name: IPCACP PCB: 8136EF00 


TFFAICAO Null 800C8C90 SCHSWAIT PROC C 

7FFA1D00 Stack 800D9250 SYSSHIBERC 0003045C IPCACP+0003045C 
7FFAID50 Stack 00030050 IPCACP+00030050 800D11C8 EXESCMKRNL C+000D8 
7FFA1E60 Null 800B6120 EXESBLDPKTSWPR C 

7FFALE78 Null 800B6120 EXESBLDPKTSWPR C 

7FFA1ECO Null 80248120 NSASCHECK PRIVILEGE C 

7FFA1FO0 Null 80084640 EXESCMODEXECX Cc 7 


TFFAIF70 Stack 800D10FO EXESCMKRNL_C _ 80084CC8 EXESCMODKRNL_C+00198 
7B01FABO Stack 00030010 IPCACP+00030010 83EA3454 SYSSIMGSTA_C+00154 
7B01FB10 Stack 83EA3300 SYSS$IMGSTA_C 83D99CC4 EXESPROC_IMGACT C+00384 
7BO1FBAOQ Stack 83D99BAQ EXESPROC_IMGACT_C+00260 83D99B9C EXESPROC_IMGACT C+0025C 


In this example, the CLUE CALL_FRAME command displays the call frame from 
the process IPCACP. 


SDA>CLUE CALL/CPU ALL 
Call Chain: Process index: 0000 Process name: NULL PCB: 827377C0 (CPU 0) 


8F629D28 Null  80205E00 SYS$SCS+05E00 
8F629D68 Null  8020A850 SCS$REC_MSGREC_C 
8F629D98 Null  914A5340 SYS$PBDRIVER+07340 
8F629DB8 Null 914A4FD0 SYSSPBDRIVER+06FDO 


8F629DEO Stack 914AACFO SYSS$PBDRIVER+0CCFO 914AE5CC SYS$PBDRIVER+105CC 
8F629E50 Stack 914AE418 SYSS$PBDRIVER+10418 800503B0 EXE STDS$QUEUE_FORK_C+00350 
8F629F88 Null 800E95F4 SCHS$WAIT ANY MODE C 

8F629FD0 Stack 800D0F80 SCHSIDLEC = ~— 800E92D0 SCH$INTERRUPT+00BB0 


Call Chain: Process index: 0000 Process name: NULL PCB: 827377C0 (CPU 2) 


Q0FCBF88 Null 800E95F4 SCHSWAIT ANY MODE C 
QOFCBFC8 Null 800E95F4 SCHSWAIT ANY MODE C 


90FCBFDO Stack 800D0F80 SCHSIDLE_C 800E92D0 SCHSINTERRUPT+00BBO 
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Call Chain: Process index: 0000 Process name: NULL PCB: 827377C0 (CPU 6) 


90FCBF88 Null 800E95FA SCHS$WAIT_ANY MORE c 
QOFD9F88 Null 800E95F4 SCHSWAIT_ANY MODE C 


90FD9FDO Stack 800DO0F80 SCHSIDLE_C 800E92D0 SCHSINTERRUPT+00BBO0 
In this example, CLUE/CPU ALL shows the call frame for all CPUs. 
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CLUE CLEANUP 


Format 


Parameters 


Qualifiers 


Description 


Example 


Performs housekeeping operations to conserve disk space. 


CLUE CLEANUP 


None. 


None. 


CLUE CLEANUP performs housekeeping operations to conserve disk space. To 
avoid filling up the system disk with listing files generated by CLUE, CLUE 
CLEANUP is run during system startup to check the overall disk space used by 
all CLUE$*.LIS files. 


If the CLUE$COLLECT:CLUE$*.LIS files occupy more space than the logical 
CLUE$MAX BLOCKS allows, then the oldest files are deleted until the threshold 
is reached. If this logical name is not defined, a default value of 5,000 disk blocks 
is assumed. A value of zero disables housekeeping and no check on the disk space 
is performed. 


SDA> CLUE CLEANUP 

%CLUE-I-CLEANUP, housekeeping started... 
%CLUE-I-MAXBLOCK, maximum blocks allowed 5000 blocks 
SCLUE-I-STAT, total of 4 CLUE files, 192 blocks. 


In this example, the CLUE CLEANUP command displays that the total number 
of blocks of disk space used by CLUE files does not exceed the maximum number 
of blocks allowed. No files are deleted. 
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CLUE CONFIG 


Displays the system, memory, and device configurations. 


Format 
CLUE CONFIG 
Parameters 
None. 
Qualifiers 
None. 
Description 
CLUE CONFIG displays the system, memory, 
Example 


SDA> CLUE CONFIG 
System Configuration: 
System Information: 


System Type AlphaServer 4100 5/400 4MB Primary CPU ID 00 


Vec/IRQ 


Port Slot 


GQA: 
EWA: 
PKA: 
PKB: 


OWN 


o 


and device configurations. 


Device Name / HW-Id 


KA1605_PCI 
KA1605_MEMORY 


MERCURY 

$3 Trio32/64 

DC21140 - 100 mbit NI (Tulip) 
Qlogic ISP1020 SCSI-2 

FWD SCSI (KZPSA) 


System Board 


Cycle Time 2.5 nsec (400 MHz) Pagesize 8192 Byte 
Memory Configuration: 
Cluster PFN Start PFN Count Range (MByte) Usage 
#00 0 256 0.0 MB - 2.0 MB Console 
#01 256 32510 2.0 MB - 255.9 MB System 
#02 32766 2 255.9 MB - 256.0 MB Console 
Per-CPU Slot Processor Information: 
CPU ID 00 CPU State rc,pa,pp,Cv,pv,pmv,pl 
CPU Type EV56 Pass 2 (21164A) Halt Request "Default, No Action" 
PAL Code 1.19-12 Halt PC 00000000.20000000 
CPU Revision aia Halt PS 00000000.00001F00 
Serial Number .......... Halt Code "Bootstrap or Powerfail" 
Console Vers V5.0-47 
CPU ID 02 CPU State pa,pp,cv,pv,pmv,pl 
CPU Type EV56 Pass 2 (21164A) Halt Request "Default, No Action" 
PAL Code 1.19-12 Halt PC 00000000.00000000 
CPU Revision aise Halt PS 00000000.00000000 
Serial Number .......... Halt Code "Bootstrap or Powerfail" 
Console Vers V5.0-47 
Adapter Configuration: 
TR Adapter ADP Hose Bus BusArrayEntry Node CSR 
1 KA1605 FFFFFFFF .8120FB40 0 GLOBAL_BUS 
2 MC_BUS FFFFFFFF.8120FF00 7 MC_BUS 
FFFFFFFF.81210150 4 FFFFFFFF.85BB8000 
FFFFFFFF .81210268 1 00000000.00000000 
3 PCL FFFFFFFF .81210300 60 PCI 
FFFFFFFF.81210550 8 FFFFFFFF.85BC2000 
FFFFFFFF.81210588 10 FFFFFFFF.85DEA000 
FFFFFFFF.812105C0 18 FFFFFFFF.85DEC000 
FFFFFFFF.812105F8 20 FFFFFFFF.85DEE000 
FFFFFFFF .81210630 28 FFFFFFFF.85DF0000 
4 EISA FFFFFFFF .81210800 60 EISA 
FFFFFFFF.81210A18 0 FFFFFFFF.85BC4000 
5 XBUS FFFFFFFF.81210DC0 60 XBUS 


FFFFFFFF.81210F98 
FFFFFFFF.81210FD0 
FFFFFFFF.81211008 
FFFFFFFF.812110B0 


FFFFFFFF.85BC4000 
FFFFFFFF.85BC4000 
FFFFFFFF.85BC4000 
FFFFFFFF.85BC4000 


UnNRO 
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DVA: 
LRA: 
IIA: 


UNrRO 


EISA_SYSTEM_BOARD 


Floppy 
Line Printer (parallel port) 
I2C bus driver 


VM-0011A-Al 
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CLUE CRASH 


Displays a crash dump summary. 


Format 
CLUE CRASH 
Parameters 
None. 
Qualifiers 
None. 
Description 
CLUE CRASH displays a crash dump summary, which includes the following 
items: 
e Bugcheck type 
e Current process and image 
e Failing PC and PS 
e Executive image section name and offset 
e General registers 
e Failing instructions 
e Exception frame, signal and mechanism arrays (if available) 
e CPU state information (spinlock related bugchecks only) 
Example 
SDA> CLUE CRASH 
Crash Time: 30-AUG-1996 13:13:46.83 
Bugcheck Type: SSRVEXCEPT, Unexpected system service exception 
Node: SWPCTX (Standalone) 
CPU Type: DEC 3000 Model 400 
VMS Version: X6AF-FT2 
Current Process: SYSTEM 
Current Image: $31SDKB0: [SYS0.][SYSMGR]X.EXE;1 
Failing PC: 00000000.00030078 SYSSK_VERSION_01+00078 
Failing PS: 00000000.00000003 
Module: X 
Offset: 00030078 
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Boot Time: 
System Uptime: 


30-AUG-1996 09:06:22.00 
0 04:07:24.83 


Crash/Primary CPU: 00/00 
System/CPU Type: 0402 
Saved Processes: 18 


Pagesize: 
Physical Memory: 


Dumpfile Pagelets: 


Dump Flags: 


8 KByte (8192 bytes) 

64 MByte (8192 PFNs, contiguous memory) 
98861 blocks 
olddump,writecomp,errlogcomp,dump_style 


Dump Type: 
EXESGL_FLAGS: 
Paging Files: 


raw,selective 
poolpging, init, bugdump 
1 Pagefile and 1 Swapfile installed 


Stack Pointers: 


KSP = 00000000.7FFA1C98 ESP = 00000000.7FFA6000 SSP = 00000000. 7FFAC100 
USP = 00000000.7AFFBADO 

General Registers: 

RO = 00000000.00000000 R1 = 00000000.7FFAIEB8 R2 = FFFFFFFF.80D0E6C0 
R3 = FFFFFFFF.80C63460 R4 = FFFFFFFF.80D12740 R5 = 00000000.000000C8 
R6 = 00000000.00030038 R7 = 00000000.7FFAIFCO R8 = 00000000.7FFAC208 
RI = 00000000.7FFAC410 R10 = 00000000.7FFAD238 R11 = 00000000.7FFCE3E0 
R12 = 00000000.00000000 R13 = FFFFFFFF.80C6EB60 R14 = 00000000.00000000 
R15 = 00000000.009A79FD R16 = 00000000.000003C4 R17 = 00000000. 7FFA1D40 
R18 = FFFFFFFF.80C05C38 R19 = 00000000.00000000 R20 = 00000000. 7FFAI1F50 
R21 = 00000000.00000000 R22 = 00000000.00000001 R23 = 00000000. 7FFF03C8 
R24 = 00000000.7FFF0040 AI = 00000000.00000003 RA = FFFFFFFF.82A21080 
PV = FFFFFFFF.829CF010 R28 = FFFFFFFF.8004B6DC FP = 00000000. 7FFAI1CA0 
PC = FFFFFFFF.82A210B4 PS = 18000000.00000000 

Exception Frame: 

R2 = 00000000.00000003 R3 = FFFFFFFF.80C63460 R4 = FFFFFFFF.80D12740 
R5 = 00000000.000000C8 R6 = 00000000.00030038 R7 = 00000000.7FFAIFCO 
PC = 00000000.00030078 PS = 00000000.00000003 

Signal Array: 64-bit Signal Array: 

Arg Count = 00000005 Arg Count = 00000005 
Condition = 0000000C Condition = 00000000.0000000C 
Argument #2 = 00010000 Argument #2 = 00000000.00010000 
Argument #3 = 00000000 Argument #3 = 00000000.00000000 
Argument #4 = 00030078 Argument #4 = 00000000.00030078 
Argument #5 = 00000003 Argument #5 = 00000000.00000003 
Mechanism Array: 

Arguments = 0000002C Establisher FP = 00000000.7AFFBADO 
Flags = 00000000 Exception FP = 00000000.7FFA1F00 
Depth = FFFFFFFD Signal Array = 00000000.7FFA1EB8 
Handler Data = 00000000.00000000 Signal64 Array = 00000000. 7FFAI1EDO 
RO = 00000000.00020000 R1 = 00000000.00000000 R16 = 00000000.00020004 
R17 = 00000000.00010050 R18 = FFFFFFFF.FFFFFFFF R19 = 00000000.00000000 
R20 = 00000000.7FFAIF50 R21 = 00000000.00000000 R22 = 00000000.00010050 
R23 = 00000000.00000000 R24 = 00000000.00010051 R25 = 00000000.00000000 
R26 = FFFFFFFF.8010ACA4 R27 = 00000000.00010050 R28 = 00000000.00000000 
System Registers: 

Page Table Base Register (PTBR) 00000000.00001136 
Processor Base Register (PRBR) FFFFFFFF .80D0E000 
Privileged Context Block Base (PCBB) 00000000. 003FE080 
System Control Block Base (SCBB) 00000000.000001DC 
Software Interrupt Summary Register (SISR) 00000000.00000000 
Address Space Number (ASN) 00000000.0000002F 
AST Summary / AST Enable (ASTSR ASTEN) 00000000.0000000F 
Floating-Point Enable (FEN) - 00000000.00000000 
Interrupt Priority Level (IPL) 00000000.00000000 
Machine Check Error Summary (MCES) 00000000.00000000 
Virtual Page Table Base Register (VPTB) FFFFFFFC.00000000 
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Failing Instruction: 
SYS$K_VERSION_01+00078 H 


Instruction Stream (last 20 instructions): 


SYSSK VERSION 01+00028: 
SYSSK VERSION 01+0002C: 
SYSS$K VERSION 01+00030: 
SYSSK VERSION 01+00034: 
SYSS$K VERSION 01+00038: 
SYSSK VERSION 01+0003C: 
SYSS$K VERSION 01+00040: 
SYSSK VERSION 01+00044: 
SYSSK VERSION 01+00048: 
SYSSK VERSION 01+0004C: 
SYSS$K VERSION 01+00050: 
SYSSK VERSION 01+00054: 
SYSSK VERSION 01+00058: 
SYSSK VERSION 01+0005C: 
SYSSK VERSION 01+00060: 
SYSSK VERSION 01+00064: 
SYSSK VERSION 01+00068: 
SYSSK VERSION 01+0006C: 
SYSS$K VERSION 01+00070: 
SYSSK VERSION 01+00074: 
SYS$K_VERSION 01+00078: 
SYSSK VERSION 01+0007C: 


SYSS$K VERSION 01+00080: 


SYS$K_VERSION 01+00084: 
SYS$K_VERSION 01+00088: 


LDL 


LDQ 
LDQ 
LDA 
JSR 
LDQ 
BIS 
BIS 
BIS 
LDQ 
LDQ 
LDQ 
LDA 
RET 
BIS 
LDA 
STO 
STO 
BIS 
STO 
LDA 
LDL 
BEQ 
LDQ 
BIS 
BIS 
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CLUE CRASH 


R28, (R28) 


R16, #X0030(R13) 
R27, #X0048(R13) 
R17, (R28) 

R26, (R26) 

R26, #X0038(R13) 
R31,SP,SP 
R31,R26,RO0 
R31,FP,SP 

R28, #X0008(SP) 
R13, #X0010(SP) 
FP, #X0018(SP) 
SP, #X0020(SP) 
R31, (R28) 
R31,R31,R31 

SP, #XFFE0 (SP) 
FP, #X0018(SP) 
R27, (SP) 
R31,SP,FP 

R26, #X0010(SP) 
R28, (R31) 

R28, (R28) 

R28, #X000007 
R26, #XFFE8 (R27) 
R31,R26,RO0 
R31,FP,SP 
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SDA CLUE Extension 
CLUE ERRLOG 


CLUE ERRLOG 


Extracts the error log buffers from the dump file and places them into the binary 
file called CLUE$ERRLOG.SYS. 


Format 
CLUE ERRLOG /[/OLD] 


Parameters 


None. 


Qualifier 


/OLD 

Dumps the errorlog buffers into a file using the old errorlog format. The default 
action, if /OLD is not specified, is to dump the errorlog buffers in the common 
event header format. 


Description 


CLUE ERRLOG extracts the error log buffers from the dump file and places them 
into the binary file called CLUE$ERRLOG.SYS. 


These buffers contain messages not yet written to the error log file at the time 
of the failure. When you analyze a failure on the same system on which it 
occurred, you can run the Error Log utility on the actual error log file to see 
these error log messages. When analyzing a failure from another system, use the 
CLUE ERRLOG command to create a file containing the failing system’s error 
log messages just prior to the failure. System failures are often triggered by 
hardware problems, so determining what, if any, hardware errors occurred prior 
to the failure can help you troubleshoot a failure. 


You can define the logical CLUE$ERRLOG to any file specification if you want 
error log information written to a file other than CLUE$ERRLOG.SYS. 


Note 


You need at least DECevent V2.9 to analyze the new common event 
header (CEH) format file. The old format file can be analyzed by 
ANALYZE/ERROR or any version of DECevent. 


Example 


SDA> CLUE ERRLOG 


Sequence Date Time 


128 11-MAY-1994 00:39:31.30 
129 11-MAY-1994 00:39:32.12 
130 11-MAY-1994 00:39:44.83 
131 11-MAY-1994 00:44:38.97 * Crash Entry 


In addition to writing the error log buffers into CLUE$ERRLOG.SYS, the CLUE 
ERRLOG command displays the sequence, date, and time of each error log buffer 
extracted from the dump file. 
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SDA CLUE Extension 


CLUE FRU 
CLUE FRU 
Outputs the Field Replacement Unit (FRU) table to a file for display by 
DECevent. 
Format 
CLUE FRU 
Parameters 
None. 
Qualifiers 
None. 
Description 


The FRU command extracts the FRU table into an output file (CLUE$FRU.SYS), 
which can then be displayed by DECevent. This command works on the running 
system, as well as on dump files. 
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SDA CLUE Extension 
CLUE HISTORY 


CLUE HISTORY 


Updates history file and generates crash dump summary output. 


Format 
CLUE HISTORY  [/qualifier] 


Parameters 


None. 


Qualifier 
/OVERRIDE 
Allows execution of this command even if the dump file has already been analyzed 
(DMP$V_OLDDUMP bit set). 

Description 


This command updates the history file pointed to by the logical name 
CLUE$HISTORY with a one-line entry and the major crash dump summary 
information. If CLUE$HISTORY is not defined, a file CLUE$HISTORY.DAT in 
your default directory will be created. 


In addition, a listing file with summary information about the system failure is 
created in the directory pointed to by CLUE$COLLECT. The file name is of the 
form CLUE$node_ddmmyy_hhmm.LIS where the timestamp (hhmm) corresponds 
to the system failure time and not the time when the file was created. 


The listing file contains summary information collected from the following SDA 
commands: 


e CLUE CRASH 

e CLUE CONFIG 

e CLUE MEMORY/FILES 

e CLUE MEMORY/STATISTIC 
e CLUE PROCESS/RECALL 

e CLUE XQP/ACTIVE 


Refer to the reference section for each of these commands to see examples of the 
displayed information. 


The logical name CLUE$FLAG controls how much information is written to the 
listing file. 


e Bit 0—Include crash dump summary 

e Bit 1—Include system configuration 

e Bit 2—Include stack decoding information 

e Bit 3—Include page and swap file usage 

e Bit 4—Include memory management statistics 


e Bit 5—Include process DCL recall buffer 
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SDA CLUE Extension 
CLUE HISTORY 


e Bit 6—Include active XQP process information 
e Bit 7—Include XQP cache header 


If this logical name is undefined, all bits are set by default internally and all 
information is written to the listing file. If the value is zero, no listing file is 
generated. The value has to be supplied in hexadecimal form (for example, 
DEFINE CLUE$FLAG 81 will include the crash dump summary and the XQP 
cache header information). 


If the logical name CLUE$SITE_PROC points to a valid and existing file, it will 
be executed as the final step of the CLUE HISTORY command (for example, 
automatic saving of the dump file during system startup). If used, this file should 
contain only valid SDA commands. 


Refer to Chapter 2, Section 2.2.3 for more information on site-specific command 
files. 
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SDA CLUE Extension 
CLUE MCHK 


CLUE MCHK 


This command is obsolete. 


Format 

CLUE MCHK 
Parameters 

None. 
Qualifiers 

None. 


Description 


The CLUE MCMK command has been withdrawn. Issuing the command produces 
the following output, explaining the correct way to obtain MACHINECHECK 
information from a crash dump. 


Please use the following commands in order to extract the errorlog buffers 
from the dumpfile header and analyze the machine check entry: 


$ analyze/crash sysS$system:sysdump.dmp 
SDA> clue errlog 

SDA> exit 

$ diagnose clueSerrlog 
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SDA CLUE Extension 
CLUE MEMORY 


CLUE MEMORY 


Displays memory- and pool-related information. 


Format 
CLUE MEMORY _ [/qualifier{,...]] 


Parameters 


None. 


Qualifiers 


/FILES 
Displays information about page and swap file usage. 


/FREE [/FULL] 
Validates and displays dynamic nonpaged free packet list queue. 


/GH [/FULL] 
Displays information about the granularity hint regions. 


/LAYOUT 
Decodes and displays much of the system virtual address space layout. 


/LOOKASIDE 
Validates the lookaside list queue heads and counts the elements for each list. 


/STATISTIC 
Displays systemwide performance data such as page fault, I/O, pool, lock 
manager, MSCP, and file system cache. 
Description 
The CLUE MEMORY command displays memory- and pool-related information. 


Examples 


1. SDA> CLUE MEMORY/FILES 
Paging File Usage (blocks): 


Swapfile (Index 1) Device DKAO: 
PFL Address FFFFFFFF. 81531340 UCB Address FFFFFFFF.814AAF00 
Free Blocks 44288 Bitmap FFFFFFFF .815313E0 
Total Size (blocks) 44288 Flags inited,swap file 
Total Write Count 0 Total Read Count ~ 90 
Smallest Chunk (pages) 2768 Largest Chunk (pages) 2768 
Chunks GEQ 64 Pages 1 Chunks LT 64 Pages 0 

Pagefile (Index 254) Device DKAO: 
PFL Address FFFFFFFF.8152E440 UCB Address FFFFFFFF .814AAF00 
Free Blocks 1056768 Bitmap FFFFFFFF .6FB16008 
Total Size (blocks) 1056768 Flags inited 
Total Write Count 0 Total Read Count 0 
Smallest Chunk (pages) 66048 Largest Chunk (pages) 66048 
Chunks GEQ 64 Pages 1 Chunks LT 64 Pages 0 


Summary: 1 Pagefile and 1 Swapfile installed 
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SDA CLUE Extension 
CLUE MEMORY 


Total Size of all Swap Files: 44288 blocks 

Total Size of all Paging Files: 1056768 blocks 

Total Committed Paging File Usage: 344576 blocks 
This example shows the display produced by the CLUE MEMORY/FILES 
command. 


2. SDA> CLUE MEMORY/FREE/FULL 
Non-Paged Dynamic Storage Pool - Variable Free Packet Queue: 


CLASSDR FFFFFFFF.80D157C0 : 64646464 64646464 00000040 80D164C0 AdN.@...dddddddd 
CLASSDR FFFFFFFF.80D164C0 : 64646464 64646464 00000080 80D17200 .rW..... dddddddd 
CLASSDR FFFFFFFF.80D17200 : 64646464 64646464 00000080 80D21ACO A.O..... dddddddd 
CLASSDR FFFFFFFF.80D21AC0 : 64646464 64646464 00000080 80D228C0 A(O..... dddddddd 
Vcc FFFFFFFF.80D228C0 : B01CA5E8 026F0040 00000040 80D23E40 @>0.@...@.0.8¥.. 
CLASSDR FFFFFFFF.80D23E40 : 64646464 64646464 00000040 80D24040 @0.@...dddddddd 
CLASSDR FFFFFFFF.80D24040 : 64646464 64646464 00000040 80D26FCO Ao0.@...dddddddd 
CLASSDR FFFFFFFF.80D26FCO : 64646464 64646464 00000080 80D274C0 AtO..... dddddddd 
CLASSDR FFFFFFFF.80D274C0 : 64646464 64646464 00000040 80D2E200 .a0.@...dddddddd 
CLASSDR FFFFFFFF.80D2E200 : 64646464 64646464 00000080 80D2E440 @40..... dddddddd 
CLASSDR FFFFFFFF.80D2E440 : 64646464 64646464 00000040 80D2F000 .0.@...dddddddd 
CLASSDR FFFFFFFF.80D2F000 : 64646464 64646464 00000080 80D2F400 .60..... dddddddd 
CLASSDR FFFFFFFF.80E91D40 : 64646464 64646464 00000500 80E983C0 A.é..... dddddddd 
CLASSDR FFFFFFFF.80E983C0 : 64646464 64646464 00031C40 00000000 ....@...dddddddd 


Free Packet Queue, Status: Valid, 174 elements 


Largest free chunk: 00031C40 (hex) 203840 (dec) bytes 
Total free dynamic space: 0003D740 (hex) 251712 (dec) bytes 


The CLUE MEMORY/FREE/FULL command validates and displays dynamic 
nonpaged free packet list queue. 


3. SDA> CLUE MEMORY/GH/FULL 
Granularity Hint Regions - Huge Pages: 


Execlet Code Region Pages/Slices 
Base/End VA FFFFFFFF.80000000 FFFFFFFF.80356000 Current Size 427/ 427 
Base/End PA 00000000.00400000 00000000.00756000 Free / 0 
Total Size 00000000.00356000 3.3 MB In Use / 427 
Bitmap VA/Size FFFFFFFF.80D17CC0 00000000.00000040 Initial Size 512/ 512 
Slice Size 00000000.00002000 Released 85/ 85 


Next free Slice 00000000.000001AB 
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Image Base End Length 
SYSSPUBLIC VECTORS FFFFFFFF.80000000 FFFFFFFF.80001A00 00001A00 
SYSSBASE IMAGE FFFFFFFF.80002000 FFFFFFFF.8000D400 0000B400 
SYSSCNBTDRIVER FFFFFFFF.8000E000 FFFFFFFF.8000F000 00001000 
SYSSNISCA BTDRIVER FFFFFFFF.80010000 FFFFFFFF.8001FA00 0000FA00 
SYSSESBTDRIVER FFFFFFFF.80020000 FFFFFFFF.80022400 00002400 
SYSSOPDRIVER FFFFFFFF.80024000 FFFFFFFF.80027C00 00003C00 
SYSTEM DEBUG FFFFFFFF.80028000 FFFFFFFF.80050200 00028200 
SYSTEM PRIMITIVES FFFFFFFF.80052000 FFFFFFFF.80089000 00037000 
SYSTEM SYNCHRONIZATION FFFFFFFF.8008A000 FFFFFFFF.80095400 0000B400 
ERRORLOG FFFFFFFF.80096000 FFFFFFFF.80099200 00003200 
SYSSCPU ROUTINES 0402 FFFFFFFF.8009A000 FFFFFFFF.800A3A00 00009A00 
EXCEPTION MON FFFFFFFF.800A4000 FFFFFFFF.800BC800 00018800 
IO ROUTINES MON FFFFFFFF.800BE000 FFFFFFFF.800E2000 00024000 
SYSDEVICE — FFFFFFFF.800E2000 FFFFFFFF.800E5C00 00003C00 
PROCESS MANAGEMENT MON FFFFFFFF.800E6000 FFFFFFFF.8010B000 00025000 
SYSSVM ~ FFFFFFFF.8010C000 FFFFFFFF.80167200 0005B200 
SHELL8K FFFFFFFF.80168000 FFFFFFFF.80169200 00001200 
LOCKING FFFFFFFF.8016A000 FFFFFFFF.8017BE00 00011E00 
MESSAGE ROUTINES FFFFFFFF.8017C000 FFFFFFFF.80182A00 00006A00 
LOGICAL NAMES FFFFFFFF.80184000 FFFFFFFF.80186C00 00002C00 
F11BXQP_ FFFFFFFF.80188000 FFFFFFFF.80190400 00008400 
SYSLICENSE FFFFFFFF.80192000 FFFFFFFF.80192400 00000400 
IMAGE MANAGEMENT FFFFFFFF.80194000 FFFFFFFF.80197A00 00003A00 
SECURITY FFFFFFFF.80198000 FFFFFFFF.801A0E00 00008E00 
SYSGETSYI FFFFFFFF.801A2000 FFFFFFFF.801A3A00 00001A00 
SYSSTRANSACTION SERVICES FFFFFFFF.801A4000 FFFFFFFF.801C5000 00021000 
SYSSUTC SERVICES FFFFFFFF.801C6000 FFFFFFFF.801C7000 00001000 
SYSSVCC MON FFFFFFFF.801C8000 FFFFFFFF.801D4E00 0000CE00 
SYSSIPC SERVICES FFFFFFFF.801D6000 FFFFFFFF.80214A00 0003EA00 
SYSLDR DYN FFFFFFFF.80216000 FFFFFFFF.80219200 00003200 
SYSSMME SERVICES FFFFFFFF.8021A000 FFFFFFFF.8021B000 00001000 
SYSSTTDRIVER FFFFFFFF.8021C000 FFFFFFFF.8022FE00 00013E00 
SYSSPKCDRIVER FFFFFFFF.80230000 FFFFFFFF.80240400 00010400 
SYSSDKDRIVER FFFFFFFF.80242000 FFFFFFFF.80251600 0000F600 
RMS FFFFFFFF.80252000 FFFFFFFF.802C5E00 00073E00 
SYSSGXADRIVER FFFFFFFF.802C6000 FFFFFFFF.802CE000 00008000 
SYSSECDRIVER FFFFFFFF.802CE000 FFFFFFFF.802D1000 00003000 
SYSSLAN FFFFFFFF.802D2000 FFFFFFFF.802D8E00 00006E00 
SYSSLAN CSMACD FFFFFFFF.802DA000 FFFFFFFF.802E6600 0000C600 
SYSSMKDRIVER FFFFFFFF.802E8000 FFFFFFFF.802F1C00 00009C00 
SYSSYRDRIVER FFFFFFFF.802F2000 FFFFFFFF.802F9600 00007600 
SYSSSODRIVER FFFFFFFF.802FA000 FFFFFFFF.802FF000 00005000 
SYSSINDRIVER FFFFFFFF.80300000 FFFFFFFF.8030EA00 0000EA00 
NETDRIVER FFFFFFFF.80310000 FFFFFFFF.80310200 00000200 
NETDRIVER FFFFFFFF.80312000 FFFFFFFF.80329E00 00017E00 
SYSSIMDRIVER FFFFFFFF.8032A000 FFFFFFFF.8032EA00 00004A00 
SYSSIKDRIVER FFFFFFFF.80330000 FFFFFFFF.8033AC00 0000AC00 
NDDRIVER FFFFFFFF.8033C000 FFFFFFFF.8033F800 00003800 
SYSSWSDRIVER FFFFFFFF.80340000 FFFFFFFF.80341600 00001600 
SYSSCTDRIVER FFFFFFFF.80342000 FFFFFFFF.8034D200 0000B200 
SYSSRTTDRIVER FFFFFFFF.8034E000 FFFFFFFF.80351800 00003800 
SYSSFTDRIVER FFFFFFFF.80352000 FFFFFFFF.80354200 00002200 
Execlet Data Region Pages/Slices 
Base/End VA FFFFFFFF.80C00000 FFFFFFFF.80CC0000 Current Size 96/ 1536 
Base/End PA 00000000.00800000 00000000.008C0000 Free / 11 
Total Size 00000000.000C0000 0.7 MB In Use / 1525 
Bitmap VA/Size FFFFFFFF.80D17D00 00000000.00000100 Initial Size 128/ 2048 
Slice Size 00000000.00000200 Released 32/  =512 


Next free Slice 00000000.000005F5 
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Image 

SYSSPUBLIC VECTORS 
SYSSBASE IMAGE 
SYSSCNBTDRIVER 

SYSSNISCA BTDRIVER 
SYSSESBTDRIVER 
SYSSOPDRIVER 

SYSTEM DEBUG 

SYSTEM PRIMITIVES 

SYSTEM SYNCHRONIZATION 
ERRORLOG 

SYSSCPU ROUTINES 0402 
EXCEPTION MON 

IO ROUTINES MON 
SYSDEVICE — 

PROCESS MANAGEMENT MON 
SYSSVM ~ 
SHELL8K 

LOCKING 

MESSAGE ROUTINES 

LOGICAL NAMES 

F11BXQP_ 

SYSLICENSE 

IMAGE MANAGEMENT 
SECURITY 

SYSGETSYI 
SYSSTRANSACTION SERVICES 
SYSSUTC_SERVICES 

SYSSVCC MON 

SYSSIPC SERVICES 

SYSLDR DYN 

SYSSMME SERVICES 
SYSSTTDRIVER 
SYSSPKCDRIVER 
SYSSDKDRIVER 

RMS 

RECOVERY UNIT SERVICES 
SYSSGXADRIVER | 
SYSSECDRIVER 

SYSSLAN 
SYSSLAN CSMACD 
SYSSMKDRIVER 
SYSSYRDRIVER 
SYSSSODRIVER 
SYSSINDRIVER 
NETDRIVER 
SYSSIMDRIVER 
SYSSIKDRIVER 
NDDRIVER 
SYSSWSDRIVER 
SYSSCTDRIVER 
SYSSRTTDRIVER 
SYSSFTDRIVER 
11 free Slices 


$0/S1 Executive Data Region 
Base/End VA FFFFFFFF.80D00000 FFFFFFFF.80ECA000 


Base 


FFFFFFFF. 
FFFFFFIF. 
FFFFFFIF. 
FFFFFFIF. 
- 80029400 
-80C29800 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFFF. 
FFFFFFFF. 
- 80C5A600 
-80C5CA00 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFIF. 
-80C79000 
-80C7A000 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFFF. 
FFFFFFFF. 
- 80C7FE00 
-80C80600 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
- 80C8BC00 
-80C91000 
FFFFFFIF. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
-80C99800 
. 80CAAC00 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFIF. 
FFFFFFIF. 
- 80CB3000 
- 80CB3C00 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
. 80CBAA00 
. 80CBB400 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFIF. 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


80000000 
80C05000 
80C25E00 
80026200 


80C2A200 
80C4E400 
80058200 
80C5A000 


80C64C00 
80C6AA00 
80C6B600 
80072600 


80C7BA00 
80C7D000 
80C7E200 
80C7FA00 


80C83000 
80083200 
80C89E00 
80C8A200 


80092200 
80092600 
80C94C00 
80C96A00 


80CAB000 
80CAF000 
80CAFC00 
80CB0800 
80CB1800 


80CB4E00 
80CB5E00 
80CB8800 
80CB9400 


80CBBC00 
80CBD800 
80CBE200 
80CBEA00 


End 


FFFFFFIF. 
FFFFFFIF. 
FFFFFFFF. 
FFFFFFFF. 
-80C29800 
-80C2A200 
FFFFFFTF. 
FFFFFFTIF. 
FFFFFFIF. 
FFFFFFIF. 
- 80C5CA00 
-80C64C00 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFIF. 
-80C7A000 
-80C7BA00 
FFFFFFIF. 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFIF. 
-80C80600 
-80C83000 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFIF. 
FFFFFFIF. 
-80C91000 
- 80092200 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
- 80CAAC00 
. 80CAB000 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFIF. 
- 80CB3C00 
. 80CB4E00 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFIF. 
FFFFFFFF. 
- 80CBB400 
- 80CBBC00 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFFT. 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


Base/End PA 00000000.00900000 00000000.00ACA000 Free 
Total Size 00000000.001CA000 


Slice Size 00000000.00002000 
Next free Slice 00000000.00000007 
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1.7 MB 
Bitmap VA/Size FFFFFFFF.80D17E00 00000000.00000020 


80005000 
80C25E00 
80026200 
80029400 


80C4E400 
80058200 
80C5A000 
80C5A600 


80C6AA00 
80C6B600 
80072600 
80079000 


80C7D000 
80C7E200 
80C7FA00 
80C7FE00 


80083200 
80C89E00 
80C8A200 
80C8BC00 


80092600 
80C94C00 
80C96A00 
80099800 


80CAF000 
80CAFC00 
80CB0800 
80CB1800 
80CB3000 


80CB5E00 
80CB8800 
80CB9400 
80CBAA00 


80CBD800 
80CBE200 
80CBEA00 
80CC0000 


Length 
00005000 
00020E00 
00000400 
00003200 
00000400 
00000A00 
00024200 
00009E00 
00001E00 
00000600 
00002400 
00008200 
00005E00 
00000C00 
00007000 
00006A00 
00001000 
00001A00 
00001600 
00001200 
00001800 
00000400 
00000800 
00002A00 
00000200 
00006C00 
00000400 
00001A00 
00005400 
00001200 
00000400 
00002600 
00001E00 
00002E00 
00011400 
00000400 
00004000 
00000C00 
00000C00 
00001000 
00001800 
00000C00 
00001200 
00001000 
00002A00 
00000C00 
00001600 
00000A00 
00000800 
00001C00 
00000A00 
00000800 
00001600 


Pages/Slices 


Current Size 229/ 229 


i 0 
In Use / 229 
Initial Size 229/ 229 
Released 0/ 0 
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Item Base End Length 

System Header FFFFFFFF.80D00000 FFFFFFFF.80D0A000 0000A000 
Error Log Allocation Buffers FFFFFFFF.80D0A000 FFFFFFFF.80D0C000 00002000 
Nonpaged Pool (initial size) FFFFFFFF.80D0EQ00 FFFFFFFF.80ECA000 001BC000 


Resident Image Code Region Pages/Slices 
Base/End VA FFFFFFFF.80400000 FFFFFFFF.80C00000 Current Size 1024/ 1024 
Base/End PA 00000000.00C00000 00000000.01400000 Free / 223 
Total Size 00000000.00800000 8.0 MB In Use / 801 
Bitmap VA/Size FFFFFFFF.80D17E20 00000000.00000080 Initial Size 1024/ 1024 
Slice Size 00000000.00002000 Released 0/ 0 
Next free Slice 00000000.00000321 
Image Base End Length 
LIBRTL FFFFFFFF.80400000 FFFFFFFF.8049EA00 0009EA00 
LIBOTS FFFFFFFF.804A0000 FFFFFFFF.804AEC00 0000EC00 
CMASTIS SHR FFFFFFFF.804B0000 FFFFFFFF.804B2600 00002600 
DPMLSSHR FFFFFFFF.804B4000 FFFFFFFF.8050B600 00057600 
DECCSSHR FFFFFFFF.8050C000 FFFFFFFF.80657000 0014B000 
SECURESHRP FFFFFFFF.80658000 FFFFFFFF.80676000 0001E000 
SECURESHR FFFFFFFF.80676000 FFFFFFFF.8068C000 00016000 
SECURESHR FFFFFFFF.8068C000 FFFFFFFF.8068C200 00000200 
LBRSHR FFFFFFFF.8068E000 FFFFFFFF.806A3E00 00015E00 
DECWSTRANSPORT COMMON FFFFFFFF.806A4000 FFFFFFFF.806B0C00 0000CC00 
CDESUNIX ROUTINES FFFFFFFF.806B2000 FFFFFFFF.806C1E00 0Q000FEO00 
DECWSXLIBSHR FFFFFFFF.806C2000 FFFFFFFF.80781C00 000BFC00 
DECWS$XTLIBSHRR5 FFFFFFFF.80782000 FFFFFFFF.807C7600 00045600 
DECWS$XMLIBSHR12 FFFFFFFF.807C8000 FFFFFFFF.8096AE00 001A2E00 
DECWSMRMLIBSHR12 FFFFFFFF.8096C000 FFFFFFFF.80994200 00028200 
DECWSDXMLIBSHR12 FFFFFFFF.80996000 FFFFFFFF.80A40400 000AA400 
223 free Slices FFFFFFFF.80A42000 FFFFFFFF.80C00000 001BE000 

$2 Executive Data Region Pages/Slices 
Base/End VA FFFFFFFE.00000000 FFFFFFFE.00050000 Current Size 40/ 8 
Base/End PA 00000000.00350000 00000000.003A0000 Free / 0 
Total Size 00000000.00050000 0.3 MB In Use / 8 
Bitmap VA/Size FFFFFFFF.80D17EA0 00000000.00000008 Initial Size  40/ 8 
Slice Size 00000000.0000A000 Released 0/ 0 
Next free Slice 00000000.00000008 
Item Base End Length 
PFN Database FFFFFFFE.00000000 FFFFFFFE.00050000 00050000 


The CLUE MEMORY/GH/FULL command displays data structures that describe 
granularity hint regions and huge pages. 
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4. SDA> CLUE MEMORY/LAYOUT 
System Virtual Address Space Layout: 


Item Base End Length 

System Virtual Base Address FFFFFEFE.00000000 

PFN Database FFFFFEFE.00000000 FFFFFEFE.00280000 00280000 
Permanent Mapping of System LIPT FFFFFEFE.00280000 FFFFFEFE.00282000 00002000 
Global Page Table (GPT) FFFFFEFE.00282000 FFFFFEFE.0089CD38 0061AD38 
Resource Hash Table FFFFFFFF.6FC1A000 FFFFFFFF.6FC22000 00008000 
Lock ID Table FFFFFFFF.6FC22000 FFFFFFFF.70000000 003DE000 
Execlet Code Region FFFFFFFF.80000000 FFFFFFFF.80800000 00800000 
Resident Image Code Region FFFFFFFF.80800000 FFFFFFFF.81000000 00800000 
System Header FFFFFFFF.81400000 FFFFFFFF.8140E000 0000E000 
Error Log Allocation Buffers FFFFFFFF.8140E000 FFFFFFFF.81414000 00006000 
Nonpaged Pool (initial size) FFFFFFFF.81414000 FFFFFFFF.817C8000 003B4000 
Nonpaged Pool Expansion Area FFFFFFFF.817C8000 FFFFFFFF.82664000 00E9C000 
Execlet Data Region FFFFFFFF.81000000 FFFFFFFF.81400000 00400000 
Fork Buffers Secondary to Primary FFFFFFFF.8268C000 FFFFFFFF.8268E000 00002000 
Erase Pattern Buffer Page FFFFFFFF.8268E000 FFFFFFFF.82690000 00002000 
363 Balance Slots, 33 pages each FFFFFFFF.826A0000 FFFFFFFF.88436000 05D96000 
Paged Pool FFFFFFFF.88436000 FFFFFFFF.887E4000 003AE000 
System Control Block (SCB) FFFFFFFF.887E4000 FFFFFFFF.887EC000 00008000 


Restart Parameter Block (HWRPB) FFFFFFFF.88832000 FFFFFFFF.88832B48 00000B48 
Erase Pattern Page Table Page FFFFFFFF.82690000 FFFFFFFF.82692000 00002000 
Posix Cloning Parent Page Mapping FFFFFFFF.88B1E0Q00 FFFFFFFF.88B20000 00002000 
Posix Cloning Child Page Mapping FFFFFFFF.88B20000 FFFFFFFF.88B22000 00002000 
Swapper Process Kernel Stack FFFFFFFF.88B56000 FFFFFFFF.88B5A000 00004000 
Swapper Map FFFFFFFF.88B60000 FFFFFFFF.88B82000 00022000 
Idle Loop’s Mapping of Zero Pages FFFFFFFF.88C5E000 FFFFFFFF.88C60000 00002000 
PrimCPU Machine Check Logout Area FFFFFFFF.88C60400 FFFFFFFF.88C60800 00000400 
PrimCPU Sys Context Kernel Stack FFFFFFFF.88C58000 FFFFFFFF.88C5C000 00004000 
Tape Mount Verification Buffer FFFFFFFF.88C62000 FFFFFFFF.88C66000 00004000 


Mount Verification Buffer FFFFFFFF.88C66000 FFFFFFFF.88C68000 00002000 
Demand Zero Optimization Page FFFFFFFF.88E68000 FFFFFFFF.88E6A000 00002000 
Executive Mode Data Page FFFFFFFF.88E6A000 FFFFFFFF.88E6C000 00002000 
System Space Expansion Region FFFFFFFF.8C000000 FFFFFFFF.FFDF0000 73DF0000 
System Page Table Window FFFFFFFF.FFDF0000 FFFFFFFF.FFFF0000 00200000 
N/A Space FFFFFFFF.FFFF0000 FFFFFFFF.FFFFFFFF 00010000 


The CLUE MEMORY/LAYOUT command decodes and displays the sytem virtual 
address space layout. 
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SDA> CLUE MEMORY/LOOKASIDE 
Non-Paged Dynamic Storage Pool - Lookaside List Queue Information: 


Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 
Listhead Addr: 


Total free space: 


analogous to the SDA command VALIDATE QUEUE. 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


FFFFFFFF 
FFFFFFFF 


-80C50400 
- 80050408 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFIF. 
- 80050430 
-80C50438 
FFFFFFIF. 
FFFFFFIF. 
FFFFFFIF. 
FFFFFFFF. 
-80C50460 
- 80050468 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFIF. 
FFFFFFTF. 
-80C50498 
-80C504A0 
FFFFFFIF. 
FFFFFFIF. 
FFFFFFFF. 
FFFFFFFF. 
-80C504C8 
-80C504D0 
FFFFFFFF. 
FFFFFFFF. 
FFFFFFIF. 
FFFFFFIF. 
-80C504F8 
-80C50500 
FFFFFFIF. 
FFFFFFIF. 
FFFFFFFF. 


80050410 
80050418 
80050420 
80050428 


80050440 
80050448 
80050450 
80050458 


80050470 
80050478 
80050480 
80050488 
80050490 


80C504A8 
80C504B0 
80C504B8 
80C504C0 


80C504D8 
80C504E0 
80C504E8 
80C504F0 


80050508 
80050510 
80050518 


00016440 (hex) 


64 Status 
128 Status: 
192 Status: 
256 Status: 
320 Status: 
384 Status: 
448 Status: 
512 Status: 
576 Status: 
640 Status: 
704 Status: 
768 Status: 
832 Status: 
896 Status: 
960 Status: 


: 1024 Status: 
: 1088 Status: 
¢ 1152 Status: 
: 1216 Status: 
: 1280 Status: 
: 1344 Status: 
: 1408 Status: 
: 1472 Status: 
: 1536 Status: 
: 1600 Status: 
: 1664 Status: 
: 1728 Status: 
: 1792 Status: 
: 1856 Status: 
: 1920 Status: 
: 1984 Status: 
: 2048 Status: 
: 2112 Status: 
: 2176 Status: 
: 2240 Status: 
: 2304 Status: 


91200 (dec) bytes 


The CLUE MEMORY/LOOKASIDE command summarizes the state of 
nonpageable lookaside lists. For each list, an indication of whether the queue 
is well formed is given. If a queue is not well formed or is invalid, messages 
indicating what is wrong with the queue are displayed. This command is 
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11 elements 
1 element 
29 elements 
3 elements 
7 elements 
1 element 
1 element 
1 element 
6 elements 
1 element 
5 elements 
1 element 
empty 

1 element 
1 element 
6 elements 
1 element 
1 element 
1 element 
2 elements 
2 elements 
1 element 
1 element 
1 element 
1 element 
1 element 
1 element 
1 element 
empty 
empty 

1 element 
1 element 
1 element 
15 elements 
empty 

1 element 


These messages can also appear frequently when you use the VALIDATE QUEUE 
command within an SDA session that is analyzing a running system. In a 
running system, the composition of a queue can change while the command is 
tracing its links, thus producing an error message. 
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6. SDA> CLUE MEMORY/STATISTIC 


Memory Management Statistics: 


Pagefaults: 


Non-Paged Pool: 


Total Page Faults 1060897 Successful Expansions 32 
Total Page Reads 393414 Unsuccessful Expansions 0 
I/O's to read Pages 163341 Failed Pages Accumulator 0 
Modified Pages Written 121 Total Alloc Requests 55596 
I/O's to write Mod Pages 19 Failed Alloc Requests 0 
Demand Zero Faults 281519 
Global Valid Faults 378701 Paged Pool: 
Modified Faults 236189 Total Failures 0 
Read Faults 0 Failed Pages Accumulator 0 
Execute Faults 28647 Total Alloc Requests 10229 
Failed Alloc Requests 0 
Direct I/0 591365 Cur Mapped Gbl Sections 653 
Buffered 1/0 589652 Max Mapped Gbl Sections 654 
Split 1/0 213 Cur Mapped Gbl Pages 12193 
Hits 83523 Max Mapped Gbl Pages 12196 
Logical Name Transl 1805476 Maximum Processes 46 
Dead Page Table Scans 0 Sched Zero Pages Created 0 
Distributed Lock Manager: Local Incoming Outgoing 
SENQ New Lock Requests 674059 0 0 
SENQ Conversion Requests 497982 0 0 
SDEQ Dequeue Requests 671626 0 0 
Blocking ASTs 26 0 0 
Directory Functions 0 0 
Deadlock Messages 0 0 
SENQ Requests that Wait 822 Deadlock Searches Performed 0 
SENQ Requests not Queued 3 Deadlocks Found 0 
MSCP Statistics: Total I0s 0 
Count of VC Failures 0 Split I0s 0 
Count of Hosts Served 0 IOs that had to Wait (Buf) 0 
Count of Disks Served 10 Requests in MemWait Queue 0 
MSCP BUFFER (SYSGEN) 128 Max Req ever in MemWait 0 
MSCP_CREDITS (SYSGEN) 8 
File System Cache: Current SYSGEN Param Hits Misses Hitrate 
File Header Cache (ACP HDRCACHE = 726) 196207 1214 99.3% 
Storage Bitmap Cache (ACP MAPCACHE = 181) 38 9 80.8% 
Directory Data Cache (ACP DIRCACHE = 726) 153415 199 99.8% 
Directory LRU (ACP DINDXCACHE= 181) 138543 106 =99.9% 
FID Cache (ACP FIDCACHE = 64) 119 6 95.2% 
Extent Cache (ACP EXTCACHE = 64) 229 9 96.2% 
Quota Cache (ACP_QUOCACHE = 365) 0 0 0.03% 
Volume Synch Locks 958 Window Turns 1464 
Volume Synch Locks Wait 0 Currently Open Files 630 
Dir/File Synch Locks 432071 Total Count of OPENs 52903 
Dir/file Synch Locks Wait 746 Total Count of ERASE QIOs 186 
Access Locks 151648 
Free Space Cache Wait 12608 
Global Pagefile Quota 785957 GBLPAGFIL (SYSGEN) Limit 786688 


The CLUE MEMORY/STATISTIC command displays systemwide performance 
data such as page fault, I/O, pool, lock manager, MSCP, and file system cache 
statistics. 
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CLUE PROCESS 


Displays process-related information from the current process context. 


Format 
CLUE PROCESS §[/qualifier{,...]] 

Parameters 
None. 

Qualifiers 
/BUFFER [/ALL] 
Displays the buffer objects for the current process. If the /ALL qualifier is 
specified, then the buffer objects for all processes (that is, all existing buffer 
objects) are displayed. 
/LAYOUT 
Displays the process P1 virtual address space layout. 
/LOGICAL 
Displays the process logical names and equivalence names, if they can be 
accessed. 
/RECALL 
Displays the DCL recall buffer, if it can be accessed. 

Description 
The CLUE PROCESS command displays process-related information from the 
current process context. Much of this information is in pageable address space 
and thus may not be present in a dump file. 

Examples 


1. SDA> CLUE PROCESS/LOGICAL 


Process Logical Names: 


"SYSSOUTPUT" = " CLAWSSLTA5004:" 
"SYSSOUTPUT" = " CLAWSSLTA5004:" 
"SYSSDISK" = "WORK1:" 

"BACKUP FILE" = " $65SDUA6" 
"SYSSPUTMSG" = "...A...A.." 
"SYSSCOMMAND" = " CLAWSSLTA5004:" 
"TAPE LOGICAL NAME" = " $1$MUA3:" 
"pp" = "LTA5004:" - 
"SYSSINPUT" = " S65SDUA6:" 
"SYSSINPUT" = " CLAWSS$LTA5004:" 
"SYSSERROR" = "21C00303.L0G" 
"SYSSERROR" = " CLAWS$LTA5004:" 
"ERROR_FILE" = "_$65$DUA6" 


The CLUE PROCESS/LOGICAL command displays logical names for each 
running process. 
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2. SDA> CLUE PROCESS/RECALL 
Process DCL Recall Buffer: 
Index Command 

1 ana/sys 
2 @login 
3 mc sysman io auto /log 
4 show device d 
5 sea <.x>*.lis clues 
6 tpu <.x>*0914.1lis 
7 sh log *hsj* 
8 xd <.x>.lis 
9 mc essS$ladcp show serv 
10 tpu clue cmd.cld 
11 ana/sys _ 


The CLUE PROCESS/RECALL command displays a listing of the DCL 
commands that have been executed most recently. 
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CLUE REGISTER 


Displays the active register set for the crash CPU. The CLUE REGISTER 
command is valid only when analyzing crash dumps. 


Format 


CLUE REGISTER 


Parameters 


None. 


Qualifiers 


None. 


Description 


The CLUE REGISTER command displays the active register set of the crash 
CPU. It also identifies any known data structures, symbolizes any system virtual 
addresses, interprets the processor status (PS), and attempts to interpret RO as a 


condition code. 


Example 


SDA> CLUE REGISTER 


Current Registers: 


RO = 00000000.00000000 
Rl = FFFFFFFF.814A2C80 
R2 = 00000000.00000000 
R3 = 00000000.23D6BBEE 
R4 = 00000000.00000064 
R5 = FFFFFFFF.831F8000 
R6 = 00000000.12F75475 
R7 = 00000000.010C7A70 
R8 = 00000000.00000001 
RI = 00000000.00000000 
R10 = 00000000.00000000 
Rll = FFFFFFFF.814A2C80 
R12 = FFFFFFFF.810AA5E0 
R13 = FFFFFFFF.810AC408 
R14 = FFFFFFFF.810AED00 
R15 = 00000000.7FFA1DD8 
R16 = 00000000.0000078C 
R17 = 00000000.00000000 
R18 = FFFFFFFF.810356C0 
R19 = FFFFFFFF.81006000 
R20 = FFFFFFFF.80120F00 
R21 = 00000000.00000000 
R22 = FFFFFFFF.00000000 
R23 = 00000000.00000000 
R24 = 00000000.00000000 
AI = FFFFFFFF.81006000 
RA = 00000000.00000000 
PV = 00000000.00000000 
R28 = FFFFFFFF.810194A0 


Process index: 0042 


Process name: BATCH 3 PCB: 817660C0 (CPU 1) 


MP CPU (CPU Id 1) 


PHD 


MP_CPU (CPU Id 1) 

SYSTEM SYNCHRONIZATION+293E0 
SMPSTIMEOUT 

SMP$GL_SCHED 


SYS$CPU_ROUTINES 2208+1D6C0 
EXESGR_SYSTEM DATA CELLS 
SCHSQEND C+00080 


EXESGR_SYSTEM DATA CELLS 


EXE$GL_TIME CONTROL 
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FP = 00000000.7FFA1F90 
PC = FFFFFFFF.800863A8 SMPSTIMEOUT_C+00068 
PS = 18000000.00000804 Kernel Mode, IPL 8, Interrupt 


5-28 SDA CLUE Extension 
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CLUE SG 


Displays the scatter-gather map. 


Format 
CLUE SG 


Parameters 


None. 


Qualifier 
/CRAB=address 


[/CRAB=adadress] 


Displays the ringbuffer for the specified Counted Resource Allocation Block 
(CRAB). The default action is to display the ringbuffer for all CRABs. 


Description 


CLUE SG decodes and displays the scatter/gather ringbuffer entries. 


Examples 


1. SDA> CLUE SG/CRAB=81224740 
Scatter/Gather Ringbuffer for CRAB 81224740: 


DMA_Addr 


ALLO 81272780 00000020 00000004 00000000 
ALLO 81272700 0000001C 00000004 00000000 
ALLO 81272680 00000018 00000004 00000000 
ALLO 81272600 00000014 00000004 00000000 
ALLO 81272580 00000010 00000004 00000000 
ALLO 81272500 0000000C 00000004 00000000 
ALLO 81272480 00000008 00000004 00000000 
ALLO 81272400 00000004 00000004 00000000 
ALLO 81272380 00000000 00000004 00000000 
DEAL 841DBEA0 00000000 0000000C c0000000 
ALLO 841DBEA0 00000000 0000000C 00000000 
DEAL 841DBEA0 00000000 00000012 c0000000 
ALLO 841DBEA0 00000000 00000012 00000000 
DEAL 841DBEA0 00000000 0000000C c0000000 
ALLO 841DBEA0 00000000 0000000C 00000000 
DEAL 841DBEA0 00000000 00000012 c0000000 
ALLO 841DBEA0 00000000 00000012 00000000 
DEAL 841DBEA0 00000000 00000012 c0000000 
ALLO 841DBEA0 00000000 00000012 00000000 
DEAL 841DBEA0 00000000 00000012 c0000000 
ALLO 841DBEA0 00000000 00000012 00000000 
DEAL 841DBEA0 00000000 00000012 c0000000 
ALLO 841DBEA0 00000000 00000012 00000000 
DEAL 841DBEA0 00000000 0000000C C0001E00 
ALLO 841DBEA0 00000000 0000000C 00000000 


In this example, the 
is displayed. 


2. SDA> CLUE SG/CRAB=8120D600 
Scatter/Gather Ringbuffer for CRAB 8120D600: 


XAct Item_Num Item_Cnt DMA_Addr 


ALLO 0001C000 00004000 


8128A380 


00000000 


00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 
00000001 


Callers PC 

847DDA94 SYSSEWDRIVER+01A94 
847DDA94 SYSSEWDRIVER+01A94 
847DDA94 SYSSEWDRIVER+01A94 
847DDA94 SYSSEWDRIVER+01A94 
847DDA94 SYSSEWDRIVER+01A94 
847DDA94 SYSSEWDRIVER+01A94 
847DDA94 SYSSEWDRIVER+01A94 
847DDA94 SYSSEWDRIVER+01A94 
847DDA94 SYSSEWDRIVER+01A94 
803B5124 SYSSPKODRIVER+0B124 
803B4FB8 SYSSPKODRIVER+0AFB8 
803B5124 SYSSPKODRIVER+0B124 
803B4FB8 SYSSPKODRIVER+0AFB8 
803B5124 SYSSPKODRIVER+0B124 
803B4FB8 SYSSPKODRIVER+0AFB8 
803B5124 SYSSPKODRIVER+0B124 
803B4FB8 SYSSPKODRIVER+0AFB8 
803B5124 SYSSPKODRIVER+0B124 
803B4FB8 SYSSPKODRIVER+0AFB8 
803B5124 SYSSPKQODRIVER+0B124 
803B4FB8 SYSSPKODRIVER+0AFB8 
803B5124 SYSSPKODRIVER+0B124 
803B4FB8 SYSSPKODRIVER+0AFB8 
803B5124 SYSSPKODRIVER+0B124 
803B4FB8 SYSSPKODRIVER+0AFB8 


00000018 
00000017 
00000016 
00000015 
00000014 
00000013 
00000012 
00000011 
00000010 
0000000F 
0000000E 
0000000D 
0000000C 
0000000B 
0000000A 
00000009 
00000008 
00000007 
00000006 
00000005 
00000004 
00000003 
00000002 
00000001 
00000000 


81240AE0 
81240AC0 
81240AA0 
81240A80 
81240A60 
81240A40 
81240A20 
81240A00 
812409E0 
812409C0 
812409A0 
81240980 
81240960 
81240940 
81240920 
81240900 
812408E0 
812408C0 
812408A0 
81240880 
81240860 
81240840 
81240820 
81240800 
812407E0) 


VM-0769A-Al 


scatter-gather ring buffer for the CRAB at address 81224740 


Status 


00000001 


Callers _PC 


8480E990 SYSSMCDRIVER+02990 


SDA CLUE Extension 


00000000 


8121C760) 


VM-0194A-Al 


5-29 
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In this example, the scatter-gather ring buffer for the CRAB address 8120D600 is 
displayed. 
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SDA CLUE Extension 
CLUE STACK 


CLUE STACK 


On Alpha, CLUE STACK identifies and displays the current stack. On I64, 
CLUE STACK only identifies the current stack without displaying it. Use the 
SDA command SHOW STACK on both Alpha and 164 to display and decode the 
whole stack for the more common bugcheck types. 


Format 
CLUE STACK 

Parameters 
None. 

Qualifiers 
None. 

Description 
The CLUE STACK command identifies and displays the current stack together 
with the upper and lower stack limits. In case of a FATALEXCPT, INVEXCEPTN, 
SSRVEXCEPT, UNXSIGNAL, or PGFIPLHI bugcheck, CLUE STACK tries to 
decode the whole stack. 

Example 


SDA> CLUE STACK 

Stack Decoder: 

Normal Process Kernel Stack: 

Stack Pointer 00000000. 7FFA1C98 

Stack Limits (low) 00000000. 7FFA0000 
(high) 00000000. 7FFA2000 


SSRVEXCEPT Stack: 


Stack Pointer SP => 00000000.7FFA1C98 


Information saved by Bugcheck: 
a(Signal Array) 00000000.7FFA1C98 00000000.00000000 


EXESEXCPTN[E] Temporary Storage: 
EXESEXCPTN[E] Stack Frame: 


PV 00000000.7FFAICAO FFFFFFFF.829CF010 EXESEXCPTN 
Entry Point FFFFFFFF.82A21000 EXESEXCPTN C 
return PC 00000000.7FFAICA8 FFFFFFFF.82A2059C SYS$CALL_HANDL_C+0002C 
saved R2 00000000.7FFAICBO 00000000.00000000 
saved FP 00000000.7FFAICB8 00000000.7FFAI1CD0 


SYSSCALL HANDL Temporary Storage: 
~ 00000000.7FFA1CCO FFFFFFFF.829CEDA8 SYSSCALL HANDL 
00000000.7FFA1CC8 00000000.00000000 ~ 
SYSSCALL_HANDL Stack Frame: 


PV 00000000.7FFAICDO FFFFFFFF.829CEDA8 SYSSCALL HANDL 
Entry Point FFFFFFFF.82A20570 SYSSCALL HANDL C 
00000000.7FFAICD8 00000000.00000000 ~ ~ 
return PC 00000000.7FFAICEO FFFFFFFF.82A1E930 CHF REI+000DC 
saved FP 00000000. 7FFAICE8 00000000.7FFA1F40 
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Fixed Exception Context Area: 


Linkage Pointer 
a(Signal Array) 
a(Mechanism Array) 
a(Exception Frame) 
Exception FP 
Unwind SP 
Reinvokable FP 
Unwind Target 

#Sig Args/Byte Cnt 
a(Msg)/Final Status 


Mechanism Array: 
Flags/Arguments 
a(Establisher FP) 
reserved/Depth 
a(Handler Data) 
a(Exception Frame) 
a(Signal Array) 
saved RO 

saved Rl 

saved R16 

saved R17 

saved R18 

saved R19 

saved R20 

saved R21 

saved R22 

saved R23 

saved R24 

saved R25 

saved R26 

saved R27 

saved R28 

FP Regs not valid 
a(Signal64 Array) 
SP Align = 10(hex) 


Signal Array: 
Arguments 
Condition 
Argument #2 
Argument #3 
Argument #4 
Argument #5 


64-bit Signal Array: 


Arguments 
Condition 
Argument #2 
Argument #3 
Argument #4 
Argument #5 


00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 


00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 


00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 


00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 


Interrupt/Exception Frame: 


saved R2 
saved R3 
saved R4 
saved R5 
saved R6 
saved R7 
saved PC 
saved PS 
SP Align = 00(hex) 


00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
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FFFFFFFF. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000005. 


829CE050. 


00000000. 
00000000. 
FFFFFFFF. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
FFFFFFFF. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
FFFFFFFF 
00000000. 
00000000. 


00000000. 


00002604. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 


00000000. 
FFFFFFFF. 
FFFFFFFF 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 


80063780 
7FFALEB8 
7FFA1D40 
7FFA1F00 
7FFA1F40 
00000000 
00000000 
00020000 
00000250 
000008F8 


0000002C 
7AFFBADO 
FFFFFFFD 
00000000 
7FFA1F00 
7FFALEB8 
00020000 
00000000 
00020004 
00010050 
FFFFFFFF 
00000000 
7FFA1F50 
00000000 
00010050 
00000000 
00010051 
00000000 


- 8010ACA4 


00010050 
00000000 


7FFA1EDO 


00000005 
0000000C 
00010000 
00000000 
00030078 
00000003 


00000005 
0000000C 
00010000 
00000000 
00030078 
00000003 


00000003 
80063460 


-80D12740 


000000C8 
00030038 
7FFALFCO 
00030078 
00000003 


EXCEPTION MON _NPRW+06D80 


SYS$K_VERSION_04 
BUGS_NETRCVPKT 
BUG$_SEQ_NUM_OVF 


SYS$K_VERSION_04 


UCBSM_NI_PRM MLT+00004 
SYSS$K_VERSION_16+00010 


SYS$K_VERSION_16+00010 
SYS$K_VERSION_16+00011 


AMACSEMUL_CALL NATIVE C+000A4 
SYS$K_VERSION_16+00010 


LDRIMGSM_NPAGED LOAD 


SYS$K_VERSION_01+00078 


LDRIMGS$M_NPAGED_ LOAD 


SYS$K_VERSION_01+00078 


EXCEPTION MON _NPRW+06A60 
PCB 


SYS$K_VERSION_01+00038 
SYS$K_VERSION_01+00078 


IPL INT CURR PREV 
00 0 Kern User 


Stack Frame: 


PV 00000000. 
Entry Point 

00000000. 
return PC 00000000. 
saved FP 00000000. 
Stack (not decoded): 

00000000. 

00000000. 
Stack Frame: 
PV 00000000. 

Entry Point 

00000000. 

00000000. 

00000000. 

00000000. 
return PC 00000000. 
saved R2 00000000. 
saved R4 00000000. 
saved R13 00000000. 
saved FP 00000000. 
Interrupt/Exception Frame: 
saved R2 00000000. 
saved R3 00000000. 
saved R4 00000000. 
saved R5 00000000. 
saved R6 00000000. 
saved R7 00000000. 
saved PC 00000000. 
saved PS 00000000. 
SP Align = 00(hex) [sie sore erase 


7FFA1F40 


7FFALF48 
7FFA1F50 
7FFA1F58 


7FFA1F60 
7FFA1F68 


7FFA1F70 


7FFALF78 
7FFA1F80 
7FFA1F88 
7FFA1F90 
7FFA1F98 
7FFAIFA0 
7FFA1FA8 
7FFA1FBO 
7FFA1FB8 


7FFA1FCO 
7FFA1FC8 
7FFA1FDO 
7FFA1FD8 
7FFA1FE0 
7FFALFE8 
7FFA1FFO 
7FFALFF8 


00000000. 
00000000. 
00000000. 
FFFFFFFF. 
00000000. 


00000000. 
- 800EE81C 


FFFFFFFF 


FFFFFFFF. 
FFFFFFFF. 
00000000. 
00010050. 
00000000. 
00000000. 
-800A4D64 
00000000. 
FFFFFFFF. 
00000000. 
00000000. 


FFFFFFFF 


00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
00000000. 
FFFFFFFF. 
00000000. 


00010050 
00030060 
00010000 
8010ACA4 
7FFALF70 


00000001 


80C6EBA0 
800EE6C0 
829CEDE8 
00000002 
00020000 
00030000 


00000003 
80D12740 
00010000 
7AFFBADO 


7FFCF880 
7B0E9851 
7FFCF818 
TFFCF938 
7TFFAC9IFO 
7FFAC9IFO 
80000140 
00000018 
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SYS$K_VERSION_16+00010 
SYS$K_VERSION_01+00060 
LDRIMG$M_NPAGED_ LOAD 
AMACSEMUL_CALL_NATIVE_C+000A4 


RM_STD$DIRCACHE BLKAST_C+005AC 


EXESCMKRNL 
EXESCMKRNL_C 
EXESSIGTORET 


SYS$K_VERSION_04 
SYS$K_VERSION_01 
__RELEASE LDBL_EXEC_SERVICE+00284 


PCB 
LDRIMGSM_NPAGED LOAD 


MMG$ IMGHDRBUF+00080 


MMG$ IMGHDRBUF+00018 
MMG$ IMGHDRBUF+00138 


SYSS$CLREF_C 
IPL INT CURR PREV 
00 O User User 


CLUE STACK identifies and displays the current stack and its upper and lower 
limit. It then decodes the current stack if it is one of the more common bugcheck 
types. In this case, CLUE STACK tries to decode the entire INVEXCEPTN stack. 
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CLUE SYSTEM 


CLUE SYSTEM 


Displays the contents of the shared logical name tables in the system. 


Format 

CLUE SYSTEM /LOGICAL 
Parameters 

None. 
Qualifier 

/LOGICAL 

Displays all the shared logical names. 
Description 

The CLUE SYSTEM/LOGICAL command displays the contents of the shared 

logical name tables in the system. 
Example 


SDA> CLUE SYSTEM/LOGICAL 


Shareable Logical Names: 


"XMICONBMSEARCHPATH" = "CDESHOME DEFAULTS: [ ICONS ]$B3M. BM" 

"MTHRTL TV" = "MTHRTL D53 TV" 

"SMGSHR TV" = "SMGSHR" 

"DECWSDEFAULT KEYBOARD MAP" = "NORTH AMERICAN LK401AA" 

"CONVSHR TV" = "CONVSHR" ~ ~ 

"XDPSSINCLUDE" = "SYSSSYSROOT: [XDPS$INCLUDE]" 

"DECWSSYSTEM DEFAULTS" = "SYSS$SYSROOT: [ DECWSDEFAULTS.USER]" 
"SYS$SPS FONT METRICS" = "SYSS$SYSROOT:[SYSFONT.PS FONT METRICS.USER]" 
"SYSSTIMEZONE NAME" = "2???" 7 ~ 
"STARTUPSSTARTUP VMS" = "SYSSSTARTUP:VMSSVMS. DAT" 


"PASMSG" = "PASSMSG" 

"UCXSHOST" = "SYSSCOMMON: [SYSEXE]UCXSHOST.DAT; 1" 
"SYSSSYLOGIN" = "SYSSMANAGER:SYLOGIN" 
"DNSSSYSTEM" = "DNSSSYSTEM TABLE" 

"IPCSACP ERRMBX" = "d.U." 

"CDESDETACHED LOGICALS" = "DECWSDISPLAY, LANG" 
"DECWSSERVER SCREENS" = "GXAQ" 

"DNSS COTOAD MBX" = "a<a." 

"DNSSLOGICAL™ = "DNSSSYSTEM" 

"OSITSMAILBOX" = "AAé." 

"XNLSSHR TV" = "XNLSSHR TV SUPPORT. EXE" 
"MOMSSYSTEM" = "SYS$SYSROOT: [MOM$SYSTEM]" 
"MOPSLOAD" = "SYSSSYSROOT:<MOMSSYSTEM>" 
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CLUE VCC 


Format 


Parameters 


Qualifiers 


Displays virtual I/O cache-related information. 


Note 


If extended file cache (XFC) is enabled, the CLUE VCC command is 
disabled. 


CLUE VCC _[/qualifier[,...]] 


None. 


/CACHE 

Decodes and displays the cache lines that are used to correlate the file virtual 
block numbers (VBNs) with the memory used for caching. Note that the cache 
itself is not dumped in a selective dump. Use of this qualifier with a selective 
dump produces the following message: 


%CLUE-I-VCCNOCAC, Cache space not dumped because DUMPSTYLE is selective 


/LIMBO 
Walks through the limbo queue (LRU order) and displays information for the 
cached file header control blocks (FCBs). 


/STATISTIC 
Displays statistical and performance information related to the virtual I/O cache. 


/VOLUME 
Decodes and displays the cache volume control blocks (CVCB). 


SDA CLUE Extension 5-35 


SDA CLUE Extension 


CLUE VCC 


Examples 


1. SDA> CLUE VCC/STATISTIC 
Virtual I/O Cache Statistics: 


Cache State 
Cache Flags 
Cache Data Area 


Total Size (pages) 


Free Size (pages) 


Read I/0 
Read Hit 


Count 
Count 


Write I/O Count 
IOpost PID Action Rtns 
IOpost Virtual I/O Count 
Read 1/0 past File HWM 
Count of Cache Block Hits 


Cache Line LRU 
Limbo LRU Queue 
Cache VCB Queue 


pak,on,img,data,enabled 


80855200 


82B11220 


on,protocol_only 


400 

0 
34243 
15910 
4040 
40829 
0 

124 
170 


82B11620 


80A97E3C 80A98B3C 


8094DE80 


2. SDA> CLUE VCC/VOLUME 


Virtual I/0 Cache - Cache VCB Queue: 


809AA000 


Total Size (MBytes) 3.1 MB 
Free Size (MBytes) 0.0 MB 
Read I/0 Bypassing Cache 3149 

Read Hit Rate 46.4% 
Write I/O Bypassing Cache 856 
IOpost Physical 1/0 Count 28 
IOpost Logical 1/0 Count 7 
Cache Id Mismatches 44 
Files Retained 100 
Oldest Cache Line Time 00001B6E 


Oldest Limbo Queue Time 00001B6F 
System Uptime (seconds) 00001BB0 


80A7E440 020007B2 8094DEBC 
809F97C0 0100022D 809F3FFC 
809F7A40 01000227 809D027C 
809F6C00 01000221 80978BBC 
809A9780 01000005 809AA83C 


8094DE80 
809F3FC0 
809D0240 
80978B80 
809AA000 


3. SDA> CLUE VCC/LIMBO 
Virtual I/0 Cache - Limbo Queue: 


CFCB 


CVCB 


FCB 


CFCB 


eee e eee fee eee-- -------- -Status- 


80A97DC0 
80A4E440 
80A63640 
80AA2540 
80A45600 
80A085C0 
80A69800 
80951000 
80A3E580 
80A67F80 
809D30C0 
809D4B80 
80A81600 
80AA3FCO 
80A98AC0 


809AA000 
809AA000 
809AA000 
80978B80 
809AA000 
809AA000 
809AA000 
809AA000 
809AA000 
809AA000 
809AA000 
809AA000 


809AA000 
809AA000 
809AA000 


80A45100 
809CD040 
809FAE80 
80A48140 
80A3AC00 
809FA140 
809FBA00 
80A3F140 
80A11A40 
80978F00 
809F4CC0 
8093E540 


8094B2C0 
80A2DECO 
8093C640 
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00000200 
00000200 
00000200 
00000200 
00000200 
00000200 
00000200 
00000200 
00000200 
00000200 
00000200 
00000200 


00000200 
00000200 
00000200 


8094DEBC 0000 0001 0002 on 
809F3FFC 0000 0001 0002 on 
809D027C 0000 0001 0002 on 
80978BBC 0000 0001 0002 on 
809AAN3C 0007 0001 0002 on 


IOerrors FID (hex) 

00000000 (076B,0001,00) 
00000000 (0767,0001,00) 
00000000 (0138,0001,00) 
00000000 (0AA5,0014,00) 
00000000 (0C50,0001,00) 
00000000 (0C51,0001,00) 
00000000 (0C52,0001,00) 
00000000 (0C53,0001,00) 
00000000 (0C54,0001,00) 
00000000 (0C55,0001,00) 
00000000 (0C56,0001,00) 
00000000 (0C57,0001,00) 


eee ee Ce 


00000000 (0C5D,0001,00) 
00000000 (07EA,000A,00) 
00000000 (0C63,0001,00) 


SDA> CLUE VCC/CACHE 
Virtual I/O Cache - Cache Lines: 


CL 


VA 


CVCB 


CFCB 


FCB 


CFCB 


eee e enn HHH nnn Hee $e eee --- -------- -Status- 


82B11200 
82B15740 
82B14ECO 
82B12640 
82B123C0 
82B13380 
82B15A40 
82B15F40 
82B12AC0 


82880000 
82AAA000 
82A66000 
82922000 
8290E000 
8298C000 
82AC2000 
82AEA000 
82946000 
82938000 
82804000 
82906000 
82A28000 
82890000 


8288C000 
82976000 
828A0000 


809D0240 
809AA000 
809AA000 
809D0240 
809AA000 
809D0240 
809AA000 
809D0240 
809D0240 
809D0240 
809AA000 
809AA000 
809AA000 
809AA000 


809AA000 
809AA000 
809AA000 


809D7000 
80A07A00 
80A45600 
809D7000 
80A45600 
809D7000 
80A45600 
809D7000 
809D7000 
809D7000 
80A45600 
80A1AC00 
809FFECO 
80A113C0 


809DA0CO 
809DA0CO 
809DA0CO 


80A01100 
80A24240 
80A3AC00 
80A01100 
80A3AC00 
80A01100 
80A3AC00 
80A01100 
80A01100 
80A01100 
80A3AC00 
80A48000 
809F8DC0 
80A11840 


809C99C0 
809C99C0 
809C99C0 


00000200 
00000000 
00000200 
00000200 
00000200 
00000200 
00000200 
00000200 
00000200 
00000200 
00000200 
00000000 
00000004 
00000000 


00002000 
00002000 
00002000 


I0errors 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


00000000 
00000000 
00000000 
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FID (hex) 


(006E,0003,00) 
(0765,0001,00) 
(0C50,0001,00) 
(006E,0003,00) 
(0C50,0001,00) 
(006E,0003,00) 
(0C50,0001,00) 
(006E,0003,00) 
(006E,0003,00) 
(006E,0003,00) 
(0C50,0001,00) 
(0164,0001,00) 
(07B8,0001,00) 
(O0AF,0001,00) 


(00AB,0001,00) 
(00AB,0001,00) 
(00AB,0001,00) 
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CLUE XQP 
CLUE XQP 

Displays XQP-related information. 
Format 

CLUE XQP_[/qualifier{,...]] 
Parameters 

None. 
Qualifiers 


/ACTIVE [/FULL] 
Displays all active XQP processes. 


/AQB 
Displays any current I/O request packets (IRPs) waiting at the interlocked queue. 


/BFRD=index 
Displays the buffer descriptor (BFRD) referenced by the index specified. The 
index is identical to the hash value. 


/BFRL=index 
Displays the buffer lock block descriptor (BFRL) referenced by the index specified. 
The index is identical to the hash value. 


/BUFFER=(n,m) [/FULL] 
Displays the BFRDs for a given pool. Specify either 0, 1, 2 or 3, or a combination 
of these in the parameter list. 


/CACHE_HEADER 
Displays the block buffer cache header. 


/FCB=address [/FULL] 

Displays all file header control blocks (FCBs) with a nonzero DIRINDX for a 
given volume. If no address is specified, the current volume of the current process 
is used. 


The address specified can also be either a valid volume control block (VCB), unit 
control block (UCB), or window control block (WCB) address. 


/FILE=address 
Decodes and displays file header (FCB), window (WCB), and cache information 
for a given file. The file can be identified by either its FCB or WCB address. 


/GLOBAL 
Displays the global XQP area for a given process. 


/LBN_HASH=Ibn 
Calculates and displays the hash value for a given logical block number (LBN). 


/LIMBO 
Searches through the limbo queue and displays FCB information from available, 
but unused file headers. 
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Description 


SDA CLUE Extension 
CLUE XQP 


/LOCK=lockbasis 
Displays all file system serialization, arbitration, and cache locks found for the 
specified lockbasis. 


/THREAD=n 

Displays the XQP thread area for a given process. The specified thread number 
is checked for validity. If no thread number is specified, the current thread is 
displayed. If no current thread, but only one single thread is in use, then that 
thread is displayed. If more than one thread exists or an invalid thread number 
is specified, then a list of currently used threads is displayed. 


/VALIDATE=(n,m) 

Performs certain validation checks on the block buffer cache to detect corruption. 
Specify 1, 2, 3, 4, or a combination of these in the parameter list. If an 
inconsistency is found, a minimal error message is displayed. If you add the 
/FULL qualifier, additional information is displayed. 


The CLUE XQP command displays XQP information. XQP is part of the I/O 
subsystem. 


Examples 
1. SDA> CLUE XQP/CACHE HEADER 
Block Buffer Cache Header: 
Cache Header 8437DF90 BFRent 000005D2 FreeBFRL 843916A0 
Bufbase 8439B400 BFRDbase 8437E080 BFRLbase 8438F7E0 
Bufsize 000BA400 LBNhashtbl 84398390 BFRLhashtbl 84399BC8 
Realsize 000D78A0 LBNhashent 0000060E BFRLhashent 0000060E 
Pool #0 #1 #2 #3 
Pool LRU 8437E5C0 84385F40 84387E90 8438EEBO 
~ 8437F400 84385D60 8438AC80 8438EE20 
Pool WAITQ 8437DFE0 8437DFE8 8437DFFO 8437DFF8 
~ 8437DFE0 8437DFE8 8437DFFO 8437DFF8 
Waitcnt 00000000 00000000 00000000 00000000 
Poolavail 00000094 00000252 00000251 00000094 
Poolcnt 00000095 00000254 00000254 00000095 
AmbigQFL 00000000 Process Hits 00000000 Cache Serial 00000000 
AmbigQBL 00000000 Valid Hits 00000000 Cache Stalls 00000000 
Disk Reads 00000000 Invalid Hits 00000000 Buffer Stalls 00000000 


Disk Writes 


00000000 Misses 00000000 


The SDA command CLUE XQP/CACHE_HEADER displays the block buffer cache 
header. 


SDA> CLUE XQP/VALIDATE=(1,4) 


Searching B 


FRD Array for possible Corruption... 


Searching Lock Basis Hashtable for possible Corruption... 


In this example, executing the CLUE XQP/VALIDATE=1,4 command indicated 
that no corruption was detected in either the BFRD Array or the Lock Basis 
Hashtable. 
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SDA Alpha OCLA 


The Alpha EV7 On-Chip Logic Analyzer (OCLA) utility enables the user to tell 
which instructions each Alpha EV7 CPU on the system has executed. 


6.1 Overview of OCLA 


OCLA enables the user to tell which instructions each Alpha EV7 CPU has 
executed by setting aside one seventh of the Alpha EV7 cache as acquisition 
memory which stores the virtual addresses of instructions executed by the Alpha 
EV7 CPU. The acquisition memory in the cache can later be analyzed with an 
SDA extension. 


The acquisition of instructions can be enabled or disabled while the system is 
running, thereby allowing the acquisition of instruction streams for a given period 
of time without the need to restart the system. 


If the OCLA is enabled and started, and your system subsequently fails due to a 
crash, the current acquisition memory is automatically saved to the system dump 
file. The instructions executed by each CPU prior to the system failure can then 
be analyzed with SDA. Upon restart of the system, the acquisition memory in 
the EV7 is still there and can be copied into system memory using the OCLA 
ENABLE/OCLA DUMP command. 


If the STOP/CPU command is issued on a CPU for which OCLA has been 
enabled, OCLA is automatically disabled if the CPU is allowed to leave the 
active set. When a CPU is started with the START/CPU command, OCLA is not 
automatically enabled; rather, it must be enabled using SDA. 


To use the OCLA utility, several new SDA commands and qualifiers are available. 
Table 6-1 describes these SDA commands and qualifiers. 
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6.2 SDA OCLA Commands 


Table 6-1 SDA Commands for the OCLA Utility 


Commands 


Description 


OCLA ENABLE 


OCLA DISABLE 


OCLA DUMP 


OCLA HELP 
OCLA LOAD 


OCLA SHOW 
REGISTER 


OCLA SHOW STATUS 


OCLA SHOW TRACE 
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Enables the OCLA. The command reserves one seventh of 
the EV7 cache as acquisition memory for instructions. The 
following qualifiers are available: 


/CPU=n 
Specifies the CPU on which to enable OCLA. If this qualifier is 
omitted, OCLA is enabled on every CPU in the system. 


/RESET 
Resets all OCLA registers to known values. 


Disables the OCLA and returns the cache set to the Alpha EV7 
CPU. The following qualifier is available: 

/CPU=n 

Specifies the CPU on which to stop acquisition. 


Copies the acquisition memory in the Alpha EV7 cache to a 
region in system space for later analysis by SDA. The following 
qualifier is available: 

/CPU=n 

Specifies the CPU for which to dump the acquisition memory. 


Provides online help about the OCLA commands. 


Loads the OCLA$PCTRACE execlet. This must be done prior 
to enabling any OCLA. It has no qualifiers. 


Displays detailed information about the OCLA registers. The 
following qualifier is available: 

/CPU=n 

Specifies the CPU for which to display registers. 

Displays the status of an OCLA. The following qualifier is 
available: 

/CPU=n 

Specifies the CPU for which to show OCLA status. 
Decodes the acquired compressed instruction stream and 
displays it. The following qualifiers are available: 

/CPU=n 

Specifies the CPU for which to show data. 


/LAST=n 
Displays the last n instructions. 


/NOPAL 

Do not include PALcode when displaying instructions. 
/REVERSE 

Displays the instructions in reverse order. 
/SUMMARY 

Displays the first 42 instructions. 

/SYMBOLIZE 

Attempts to symbolize each instruction. 


(continued on next page) 
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Table 6-1 (Cont.) SDA Commands for the OCLA Utility 


Commands 


Description 


OCLA START 


OCLA STOP 


OCLA UNLOAD 


Starts the acquisition of instructions into the acquisition 
memory. The following qualifier is available: 


/CPU=n 

Specifies the CPU on which to start OCLA. 

Stops the acquisition of instructions. The following qualifier is 
available: 


/CPU=n 
Specifies the CPU on which to stop acquisition. 


Unloads the OCLA$PCTRACE execlet and returns the 
acquisition buffers to the system. 
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OCLA DISABLE 


OCLA DISABLE 


Disables the OCLA and returns the cache set to the Alpha EV7 CPU. 


Format 
OCLA DISABLE [/CPU=n] 


Parameters 


None. 


Qualifier 


/CPU=n 
Specifies the CPU on which to stop acquisition. If this qualifier is omitted, OCLA 
is disabled on every CPU in the system. 


Description 


The OCLA DISABLE command disables the OCLA and returns the cache set to 
the Alpha EV7 CPU. 
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OCLA DUMP 


OCLA DUMP 


Copies the acquisition memory in the Alpha EV7 cache to a region in system 
space for later analysis by SDA. 


Format 
OCLA DUMP [/CPU=n] 


Parameters 


None. 


Qualifier 


/CPU=n 
Specifies the CPU for which to dump the acquisition memory. If this qualifier is 
omitted, the acquisition memory is dumped for all CPUs. 


Description 


The OCLA DUMP command copies the acquisition memory in the Alpha EV7 
cache to a region in system space for later analysis by SDA. 
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OCLA ENABLE 


OCLA ENABLE 


Enables the OCLA. Reserves one-seventh of the EV7 cache as acquisition memory 
for instructions. 


Format 
OCLA ENABLE [/CPU=n] 
Parameters 
None. 
Qualifiers 
/CPU=n 
Specifies the CPU on which to enable OCLA. If this qualifier is omitted, OCLA is 
enabled on every CPU in the system. 
/RESET 
Resets all OCLA registers to known values. 
Description 


The OCLA ENABLE command enables OCLA. 
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OCLA HELP 


OCLA HELP 


Provides online help on OCLA commands. 


Format 
OCLA HELP 


Parameters 


None. 


Qualifiers 


None. 


Description 


The OCLA HELP command provides online help on OCLA commands. 
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OCLA LOAD 


OCLA LOAD 


Loads the OCLA$PCTRACE execlet. This must be done before enabling any 
OCLA. 


Format 
OCLA LOAD 


Parameters 


None. 


Qualifiers 


None. 


Description 


The OCLA LOAD command loads the OCLA$PCTRACE execlet. This must be 
done before enabling any OCLA. 
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OCLA SHOW REGISTER 


OCLA SHOW REGISTER 


Displays detailed information about OCLA registers. 


Format 

OCLA SHOW REGISTER [/CPU=n] 
Parameters 

None. 
Qualifier 

/CPU=n 


Specifies the CPU for which to display registers. If this qualifier is omitted, 
registers are displayed for all CPUs. 


Description 
Displays detailed information about OCLA registers. 
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OCLA SHOW STATUS 


OCLA SHOW STATUS 


Displays the status of an OCLA. 


Format 
OCLA SHOW STATUS [/CPU=n] 


Parameters 


None. 


Qualifier 


/CPU=n 
Specifies the CPU for which to show OCLA status. If this qualifier is omitted, 
status is displayed for all CPUs. 


Description 
Displays the status of an OCLA. 
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OCLA SHOW TRACE 


OCLA SHOW TRACE 


Format 


Parameters 


Qualifiers 


Description 


Decodes the acquired compressed instruction stream and displays it. 


OCLA SHOW TRACE [/CPU=n] 
[/LAST=n][/NOPAL][//REVERSE][/SUMMARY][/SYMBOLIZE] 


None. 


/CPU=n 
Specifies the CPU for which to show data. If this qualifier is omitted, trace data 
is displayed for all CPUs. 


/LAST=n 
Displays the last n instructions. If this qualifier is omitted, trace data is 
displayed for all instructions. 


/NOPAL 
Do not include PAL code when displaying instructions. 


/REVERSE 
Displays the instructions in reverse order. 


/SUMMARY 
Displays the first 42 instructions. 


/SYMBOLIZE 
Attempts to symbolize each instruction. 


Decodes the acquired compressed instruction stream and displays it. 
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OCLA START 


OCLA START 


Starts the acquisition of instructions into acquisition memory. 


Format 

OCLA START [/CPU=n] 
Parameters 

None. 
Qualifier 

/CPU=n 


The CPU on which to start instruction acquisition. If this qualifier is omitted, 
instruction acquisition is started on all CPUs. 


Description 


Starts the acquisition of instructions into acquisition memory. 
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OCLA STOP 


OCLA STOP 


Stops the acquisition of instructions. 


Format 

OCLA STOP [/CPU=n] 
Parameters 

None. 
Qualifier 

/CPU=n 


Specifies the CPU on which to stop acquisition. If this qualifier is omitted, 
acquisition is stopped on all CPUs. 


Description 


Stops the acquisition of instructions. 
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OCLA UNLOAD 


OCLA UNLOAD 
Unloads the OCLA$PCTRACE execlet and returns the acquisition buffers to the 
system. 
Format 
OCLA UNLOAD 
Parameters 
None. 
Qualifiers 
None. 
Description 
Unloads the OCLA$PCTRACE execlet and returns the acquisition buffers to the 
system. 
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SDA Alignment Fault Utility (FLT) 


The Alignment Fault Utility can be used to find alignment faults. 


7.1 Overview of FLT 


The utility can be started and stopped as required without the need for a system 
reboot. It records all alignment faults into a ring buffer, which can be sized when 
starting alignment fault tracing. The summary screen displays the results sorted 
by the program counter (PC) that has incurred the most alignment faults. The 
detailed trace output also shows the process identification (PID) of the process 
that caused the alignment fault, with the virtual address that triggered the fault. 


Output can be directed to a file with the SDA SET OUTPUT command. 


7.2 FLT Commands 


To use the FLT utility, several commands and qualifiers are available. Table 7-1 
describes these commands and qualifiers. 


Table 7-1 Commands for the Alignment Fault Utility 


Commands Description 
FLT LOAD Loads the FLT$DEBUG execlet. 
FLT UNLOAD Unloads the FLT$DEBUG execlet. 


FLT START TRACE 


FLT 
FLT STOP TRACE 
FLT SHOW TRACE 


Starts alignment fault tracing. 


[/BUFFER=pages] - the number of pages to size the trace 
buffer (default = 128 pages = 1MB). 


|/BEGIN=pc_range_low]|[/END=pc_range_high] 
Lists the FLT commands. 
Stops tracing. 


Displays detailed information about the trace. The following 
qualifier is available: 

/SUMMARY 

Displays the results sorted by the program counter (PC) that 
has incurred the most alignment faults. 


SDA Alignment Fault Utility (FLT) 7-1 


SDA Alignment Fault Utility (FLT) 


FLT 
FLT 
Lists the FLT commands. 
Format 
FLT 
Parameters 
None. 
Qualifiers 
None. 


Description 
When entered by itself, the FLT command lists the available FLT commands. 


Example 


SDA> FLT 
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FLT LOAD 


FLT LOAD 


Loads the FLT$DEBUG execlet. Do this before starting alignment fault tracing. 


Format 
FLT LOAD 


Parameters 


None. 


Qualifiers 


None. 


Description 
The FLT LOAD command loads the FLT$DEBUG execlet. 


Example 


SDA> FLT LOAD 
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FLT SHOW TRACE 


FLT SHOW TRACE 


Displays detail about the trace. 


Format 
FLT SHOW TRACE /SUMMARY 
Parameters 
None. 
Qualifier 
/SUMMARY 
Displays the results sorted by the program counter (PC) that has incurred the 
most alignment faults. 
Description 
The FLT SHOW TRACE command displays detail about the trace. 
Example 


SDA> FLT SHOW TRACE 
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FLT START TRACE 


FLT START TRACE 


Starts alignment fault tracing. 


Format 
START TRACE [/BUFFER=pages] [/BEGIN=pc_range_low][/END=pc_range_high] 
Parameters 
None. 
Qualifiers 
/BUFFER=pages 
The number of pages to size the trace buffer. The default is 128 pages or 1MB. 
/BEGIN=pc_range_low 
Start of range of PCs to trace. 
/END=pc_range_high 
End of range of PCs to trace. 
Description 
The FLT START TRACE command starts alignment fault tracing. By default, all 
PCs are traced. 
Example 


SDA> FLT START TRACE 
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FLT STOP TRACE 


FLT STOP TRACE 


Stops tracing. 


Format 
FLT STOP TRACE 


Parameters 


None. 


Qualifiers 


None. 


Description 
The FLT STOP TRACE command stops tracing. 


Example 


SDA> FLT STOP TRACE 
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FLT UNLOAD 


FLT UNLOAD 


Unloads the FLT$DEBUG execlet. 


Format 
FLT UNLOAD 


Parameters 


None. 


Qualifiers 


None. 


Description 


The FLT UNLOAD command unloads the FLT$DEBUG execlet. 


Example 


SDA> FLT UNLOAD 
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FLT UNLOAD 


Figure 7-1 FLT Example 


SDA> flt load 
SDA> flt start trace 


SDA> flt show trace /summary 


Fault Trace Information: 


(at 12-OCT-2004 16:09:29.43, trace time 00:00:55.145335) 


Exception PC Count Exception PC Module Offset 
FFFFFFFF. 86214790 973 RDMSHRP72+0019E790 RDMSHRP72 0019E790 
FFFFFFFF.86214791 871 RDMSHRP72+0019E791 RDMSHRP72 0019E791 
FFFFFFFF.8620B261 700 RDMSHRP72+00195261 RDMSHRP72 00195261 
FFFFFFFF .8620B260 700 RDMSHRP72+00195260 RDMSHRP72 00195260 
FFFFFFFF.841C3451 208 LIBRTL+00195451 LIBRTL 00195451 
FFFFFFFF.818E43E0 193 NETS$TRANSPORT_NSP+303E0 NET$TRANSPORT_NSP 000303E0 
FFFFFFFF.818E4400 193 NETSTRANSPORT_NSP+30400 NETS$TRANSPORT_NSP 00030400 
FFFFFFFF .818E4430 193 NETS$TRANSPORT_NSP+30430 NET$TRANSPORT_NSP 00030430 
FFFFFFFF.818E4450 193 NETSTRANSPORT_NSP+30450 NETS$TRANSPORT_NSP 00030450 
FFFFFFFF.818E44B1 193 NETS$TRANSPORT_NSP+304B1 NETS$TRANSPORT_NSP 000304B1 
FFFFFFFF.818E44D0 193 NETSTRANSPORT_NSP+304D0 NETS$TRANSPORT_NSP 000304D0 
FFFFFFFF.818E6720 186 NETSTRANSPORT_NSP+32720 NETS$TRANSPORT_NSP 00032720 
FFFFFFFF.818E64C0 179 NETS$TRANSPORT_NSP+324C0 NETS$TRANSPORT_NSP 000324c0 
FFFFFFFF.818E6520 179 NETSTRANSPORT_NSP+32520 NETS$TRANSPORT_NSP 00032520 
FFFFFFFF .86DE9480 166 RDMSHRP72+00D73480 RDMSHRP72 00D73480 
FFFFFFFF.807814A1 162 EXE$SETOPR_C+00841 MESSAGE ROUTINES 0001D7A1 
FFFFFFFF .86DE8C90 146 RDMSHRP72+00D72C90 RDMSHRP72 00D72C90 
FFFFFFFF .86DE8ECO 146 RDMSHRP72+00D72ECO RDMSHRP72 00D72ECO 
FFFFFFFF.8701C340 146 RDMSHRP72+00FA6340 RDMSHRP72 OO0FA6340 
FFFFFFFF.862026E1 100 RDMSHRP72+0018C6E1 RDMSHRP72 0018C6E1 
FFFFFFFF . 86202580 100 RDMSHRP72+0018C580 RDMSHRP72 0018C580 
FFFFFFFF .862025B0 100 RDMSHRP72+0018C5BO0 RDMSHRP72 0018C5B0 
FFFFFFFF.8701B900 83 RDMSHRP72+00FA5900 RDMSHRP72 O0OFA5900 
00000000. 000EE990 37 

00000000. 000EEA51 37 

00000000. 000EE8D1 37 

FFFFFFFF.807359C1 28 LOCKING+253C1 LOCKING 000253C1 
FFFFFFFF.807359F1 28 LOCKING+253F1 LOCKING 000253F1 
FFFFFFFF .80732EE0 27 LCK$FILL_RSB_CACHE_C+008F0 LOCKING 00022850 
FFFFFFFF .86DE8690 18 RDMSHRP72+00D72690 RDMSHRP72 00D72690 
FFFFFFFF .80B388A0 15 SECURITY+461A0 SECURITY 000461A0 
FFFFFFFF .80B213F0 13 NSAS$SIZE_NSAB_C+00840 SECURITY 0002ECFO 
FFFFFFFF .86DFE9E0 12 RDMSHRP72+00D889E0 RDMSHRP72 00D889E0 

[is atdmawcioeenee die ] 

SDA> flt show trace 

Unaligned Data Fault Trace Information: 

Timestamp CPU Unaligned VA Exception PC Access EPID Trace Buffer 
12-OCT 16:09:56.439499 02 00000000.014A4F8A 86214791 RDMSHRP72+0019E791 Exec 39C004DC FFFFFFFF.74921610 
12-OCT 16:09:56.439493 02 00000000.023DFFD4 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.749215E8 
12-OCT 16:09:56.439486 02 00000000.014A4F42 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.749215C0 
12-OCT 16:09:56.439480 02 00000000.014A4F8A 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921598 
12-OCT 16:09:56.439254 02 00000000.0154F1DC 807814Al EXESSETOPR_C+00841 Exec 39C004DC FFFFFFFF.74921570 
12-OCT 16:09:56.431606 02 00000000.014A4F5A 86214791 RDMSHRP72+0019E791 Exec 39C004DC FFFFFFFF.74921548 
12-OCT 16:09:56.431601 02 00000000.022DEE44 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921520 
12-OCT 16:09:56.431594 02 00000000.014A4F42 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.749214F8 
12-OCT 16:09:56.431588 02 00000000.014A4F5A 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.749214D0 
12-OCT 16:09:56.430255 02 00000000.0155BDDC 807814Al EXESSETOPR_C+00841 Exec 39C004DC FFFFFFFF.749214A8 
12-OCT 16:09:56.426878 02 00000000.014A4F72 86214791 RDMSHRP72+0019E791 Exec 39C004DC FFFFFFFF.74921480 
12-OCT 16:09:56.426872 02 00000000.02394ED4 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921458 
12-OCT 16:09:56.426865 02 00000000.014A4F42 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921430 
12-OCT 16:09:56.426859 02 00000000.014A4F72 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921408 
12-OCT 16:09:56.426583 02 00000000.0154A97C 807814Al EXESSETOPR_C+00841 Exec 39C004DC FFFFFFFF.749213E0 
12-OCT 16:09:56.421244 02 00000000.014A4F52 86214791 RDMSHRP72+0019E791 Exec 39C004DC FFFFFFFF.749213B8 
12-OCT 16:09:56.421238 02 00000000.02296824 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921390 
12-OCT 16:09:56.421232 02 00000000.014A4F42 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921368 
12-OCT 16:09:56.421226 02 00000000.014A4F52 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921340 
12-OCT 16:09:56.420916 02 00000000.0156405C 807814Al EXESSETOPR_C+00841 Exec 39C004DC FFFFFFFF.74921318 
12-OCT 16:09:56.413932 02 00000000.014A4F52 86214791 RDMSHRP72+0019E791 Exec 39C004DC FFFFFFFF.749212F0 
12-OCT 16:09:56.413926 02 00000000.023C10D4 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.749212C8 
12-OCT 16:09:56.413918 02 00000000.014A4F42 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.749212A0 
12-OCT 16:09:56.413913 02 00000000.014A4F52 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921278 
12-OCT 16:09:56.413645 02 00000000.01564E9C 807814Al EXESSETOPR_C+00841 Exec 39C004DC FFFFFFFF.74921250 
12-OCT 16:09:56.403972 02 00000000.014A4F52 86214791 RDMSHRP72+0019E791 Exec 39C004DC FFFFFFFF.74921228 
12-OCT 16:09:56.403966 02 00000000.023036C4 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921200 
12-OCT 16:09:56.403960 02 00000000.014A4F42 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.749211D8 
12-OCT 16:09:56.403954 02 00000000.014A4F52 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.749211B0 
12-OCT 16:09:56.403689 02 00000000.0155E47C 807814Al EXESSETOPR_C+00841 Exec 39C004DC FFFFFFFF.74921188 
12-OCT 16:09:56.395575 02 00000000.014A4F8A 86214791 RDMSHRP72+0019E791 Exec 39C004DC FFFFFFFF.74921160 
12-OCT 16:09:56.395569 02 00000000.02448D24 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921138 
12-OCT 16:09:56.395562 02 00000000.014A4F42 86214790 RDMSHRP72+0019E790 Exec 39C004DC FFFFFFFF.74921110 
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SDA Spinlock Tracing Utility (SPL) 


This chapter presents an overview of the SDA Spinlock Tracing Utility 
commands, and describes the SDA Spinlock Tracing commands. 


8.1 Overview of the SDA Spinlock Tracing Utility 


To synchronize access to data structures, the OpenVMS operating system uses 
a set of static and dynamic spinlocks, such as IOLOCK8 and SCHED. The 
operating system acquires a spinlock to synchronize data, and at the end of the 
critical code path the spinlock is then released. If a CPU attempts to acquire 

a spinlock while another CPU is holding it, the CPU attempting to acquire the 
spinlock has to spin, waiting until the spinlock is released. Any lost CPU cycles 
within such a spinwait loop are charged as MPsynch time. 


By using the MONITOR utility, you can monitor the time in process modes, 
for example, with the command $ MONITOR MODES. A high rate of 

MP synchronization indicates contention for spinlocks. However, until the 
implementation of the Spinlock Tracing utility, there was no way to tell which 
spinlock was heavily used, and who was acquiring and releasing the contended 
spinlocks. The Spinlock Tracing utility allows a characterization of spinlock 
usage. It can also collect performance data for a given spinlock on a per-CPU 
basis. 


This tracing ability is built into the system synchronization execlet, which 
contains the spinlock code, and can be enabled or disabled while the system is 
running. There is no need to reboot the system to load a separate debug image. 
The images that provide spinlock tracing functionality are as follows: 


SYS$LOADABLE_IMAGES:SPL$DEBUG.EXE 
SYS$SHARE:SPL$SDA.EXE 


The SDA> prompt provides the command interface. From this command 
interface, you can load and unload the spinlock debug execlet using SPL LOAD 
and SPL UNLOAD, and start, stop and display spinlock trace data. This allows 
you to collect spinlock data for a given period of time without system interruption. 
Once information is collected, the trace buffer can be deallocated and the execlet 
can be unloaded to free up system resources. The spinlock trace buffer is 
allocated from S2 space and pages are taken from the free page list. 


Should the system crash while spinlock tracing is enabled, the trace buffer is 
dumped into the system dump file, and it can later be analyzed using the spinlock 
trace utility. This is very useful in tracking down CPUSPINWAIT bugcheck 
problems. 


Note that by enabling spinlock tracing, there is a performance impact. The 
amount of the impact depends on the amount of spinlock usage. 
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8.2 How to Use the SDA Spinlock Tracing Utility 


The following steps will enable you to collect spinlock statistics using the Spinlock 
Tracing Utility. 


1. 


Load the Spinlock Tracing Utility execlet. 
SDA> SPL LOAD 

Allocate a trace buffer and start tracing. 
SDA> SPL START TRACE 


Wait a few seconds to allow some tracing to be done, then find out which 
spinlocks are incurring the most acquisitions and the most spinwaits. 


SDA> SPL SHOW TRACE/SUMMARY 


For example, you might see contention for the SCHED and IOLOCK8 
spinlocks (a high acquisition count, with a significant proportion of the 
acquisitions being forced to wait). 


Look to see if the spinlocks with a high proportion of spinwaits caused a 
significant delay in the acquisition of the spinlock. You must now collect more 
detailed statistics on a specific spinlock. 


SDA> SPL START COLLECT/SPINLOCK=SCHED 


This command accumulates additional data for the specified spinlock. 
As long as tracing is not stopped, collection will continue to accumulate 
spinlock-specific data from the trace buffer. 


Display the additional data collected for the specified spinlock. 
SDA> SPL SHOW COLLECT 


This display includes the average hold time of the spinlock and the average 
spinwait time while acquiring the spinlock. 


Repeat steps 4 and 5 for each spinlock that has contention. A START 
COLLECT cancels the previous collection. 


Disable spinlock tracing when you have collected all the needed spinlock 
statistics and release all the memory used by the Spinlock Tracing utility 
with the following commands. 


SDA> SPL STOP COLLECT 
SDA> SPL STOP TRACE 
SDA> SPL UNLOAD 


8.3 Example Command Procedure for Collection of Spinlock 


Statistics 


The following example shows a command procedure that can be used for 
gathering spinlock statistics: 
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8.3 Example Command Procedure for Collection of Spinlock Statistics 


$ analyze/system 
spl load 
spl start trace/buffer=1000 
wait 00:00:15 
spl stop trace 
read/executive/nolog 
set output spl trace.lis 
spl analyze — 
spl show trace/summary 
spl start collect/spin=sched 
wait 00:00:05 
spl show collect 
spl start collect/spin=iolock8 
wait 00:00:05 
spl show collect 
spl start collect/spin=lckmgr 
wait 00:00:05 
spl show collect 
spl start collect/spin=mmg 
wait 00:00:05 
spl show collect 
spl start collect/spin=timer 
wait 00:00:05 
spl show collect 
spl start collect/spin=mailbox 
wait 00:00:05 
spl show collect 
spl start collect/spin=perfmon 
wait 00:00:05 
spl show collect 
spl stop collect 
spl unload 
exit 

$ exit 


A more comprehensive procedure is provided as SYS$EXAMPLES:SPL.COM. 


8.4 SDA Spinlock Tracing Commands 
The following is a list of the spinlock tracing commands: 


SPL ANALYZE 

SPL LOAD 

SPL SHOW COLLECT 
SPL SHOW TRACE 
SPL START COLLECT 
SPL START TRACE 
SPL STOP COLLECT 
SPL STOP TRACE 
SPL UNLOAD 


SDA Spinlock Tracing Utility (SPL) 8-3 


SDA Spinlock Tracing Utility (SPL) 
SPL ANALYZE 


SPL ANALYZE 


Format 


Parameters 


Qualifiers 


Description 


Analyzes collected spinlock data and presents the most relevant data. 


SPL ANALYZE [/[NO]JCPU_STATISTICS |/[NO]JPLATFORM 
| /[NOJHOLD_TIMES=n/[NO]WAIT_TIMES=n 
| /[NOJUSAGE=(HOLD=n,SPIN=n, TOP_PCS=n)] 


None. 


/CPU_STATISTICS (default) 
/NOCPU_STATISTICS 
Displays per-CPU statistics. 


/PLATFORM (default) 
/NOPLATFORM 
Displays system platform information. 


/HOLD_TIMES=n 

/NOHOLD_TIMES=n 

Displays occurrences of spinlocks held longer than n microseconds. The default is 
1000 microseconds. 


NWAIT_TIMES=n 

/NOWAIT_TIMES=n 

Displays occurrences of spinlocks held longer than n microseconds. The default is 
1000 microseconds. 


/USAGE=(HOLD=n,SPIN=n, TOP_PCS=n) 

Specifies thresholds for displaying information on a spinlock. If the percentage 
of time a spinlock is held exceeds the value of HOLD=n, where n is a value from 
0 to 100, displays the information on the spinlock. The default is 10%. If the 
percentage of time a spinlock is spinning exceeds the value of SPIN=n, displays 
the information on the spinlock. The default is 10%. If either the HOLD or SPIN 
thresholds are exceeded, displays information on a spinlock. The TOP_PCS=n 
keyword displays the top n unique callers to lock a spinlock. The default is to 
display the top five unique callers. 


By specifying either /USAGE=(HOLD=0) or /USAGE=(SPIN=0), SPL displays 
information on all spinlock usage from the trace buffer. 


The SPL ANALYZE command analyzes collected spinlock data and displays the 
most relevant data. 


The SPL ANALYZE command provides an overview of SPINLOCK usage on a 
system. Data are provided by CPU and by spinlock. When looking at a system 
with high MP_Synch time, this is a good command to start with. Stop spinlock 
tracing before using this command. 
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Example 

SDA> SPL ANALYZE/H 

Spinlock Analysis 
Platform 


OLD=50/WAIT=50/USAGE=HOLD=5 
(1) 


Node: CLU21 
Hardware: AlphaSe 
Active CPUs: 4 
Memory: 16.00 GB 
CPU Frequency: 1. 


Trace Buffer: 128 
Trace Time: 0.48 


rver ES45 Model 2 


000 GHz 


0 pages (10.00 MB) 
seconds 


Trace Start: 15-OCT 10:51:53.427386 


CPU statistics (2) 
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SPL ANALYZE 


% Time in % Time % Time All Spinlocks All Spinlocks 
CPU ID Fork Dispatcher Spinlocks Held MP Synch Acquires/sec Waits/sec 
00 0.1 16.2 1.1 82210.4 1434.7 
01 0.1 15.8 1.2 79551.5 1548.3 
02 0.0 16.4 1.2 85690.9 1511.1 
03 1.7 17.7 1.1 86601.3 1451.2 
Total 1.9 66.1 4.6 334054.1 5945.3 
Spinlock Usage (3) 
Spin to 
Spinlock % Time Held Acquires/sec Average Hold % Time Spinning Waits/sec Average Spin Hold Ratio 
FILSYS 15.6 33776.8 4609 2.6 2314.1 11379 0.2 
LCKMGR 9.3 26198.6 3560 1.2 2208.8 5494 0.1 
PCBS00000426 7.2 49420.4 1451 0.0 35.1 6342 0.0 
PCBS00000428 7.1 49125.2 1437 0.0 14.5 7532 0.0 
Spinlock (4) % Time Acquires Spinwaits Average 
Caller's PC Held /sec Average /sec Spinwait 
FILSYS 
8022CA44 SEARCH FCB C+00604 12.0 4021.3 29793 303.5 11985 
80222E10 SET DIRINDX C+00030 0.5 4194.7 1163 247.7 11477 
8021B06C START REQUEST C+0006C 0.4 2438.0 1607 384.0 15838 
8021B208 FINISH REQUEST C+00058 0.4 2440.1 1510 206.4 15862 
800FC508 IOC STDSMAPVBLK C+000C8 0.3 2014.8 1713 402.5 9518 
LCKMGR ~ ~ 
801DEB14 EXESENQ C+00A44 3.5 12984.7 2657 988.8 5727 
801E3B94 EXESDEQ C+00114 3.0 5943.2 5109 538.8 4849 
801E03BC LOCKING+023BC 2.6 5941.2 4315 392.2 5682 
801E5C84 LCKSDEQLOCK C+00F54 0.3 1323.2 2091 289.0 5642 
PCBS$00000426 ~ 
801782F8 SCHSASTDEL_C+00078 1.9 15525.9 1256 0.0 0 
80179AC4 SCHSQAST C+00094 1.7 8907.6 1935 0.0 0 
8017A780 SCHSQUEUE AST CURRENT C+00070 152 7859.0 1532 0.0 0 
80178FEO SCHSASTDEL K C+00090 — 1.2 8895.3 1320 8.3 2346 
80179124 SCHSASTDEL K C+001D4 1.1 7780.5 1355 0.0 0 
PCBS$00000428 a 
801782F8 SCHSASTDEL_C+00078 2.0 15606.4 1308 0.0 0 
80179AC4 SCHSQAST C+00094 1.6 8810.6 1794 0.0 0 
80178FEO SCHS$ASTDEL K C+00090 1.2 8810.6 1344 6.2 2589 
8017A780 SCHSQUEUE AST CURRENT C+00070 1.2 7904.4 1492 0.0 0 
80179124 SCHSASTDEL K C+001D4 ~ 1.0 7128.9 1340 0.0 0 
8017A780 SCHS$QUEUE_AST CURRENT _C+00070 Tl 8655.8 1298 0.0 0 
80179124 SCHSASTDEL K C+001D4 Let 8598.0 1225 0.0 0 
80178FE0 SCHSASTDEL K C+00090 ips 9192.5 1144 2.1 2326 


Long Spinlock Hold Times (> 50 microseconds) (5) 
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SPL ANALYZE 

Timestamp CPU Spinlock | Forklock Calling PC | Forking PC EPID Hold (us) 
15-OCT 10:51:53.801244 00 81D6A200 81D6A200 8051B380 LANSCOMPLETE VCRP_CSMACD C+00 00000000 64 
15-OCT 10:51:53.538665 00 818BBE00 POOL 8004B334 EXESALONPAGVAR C+002F4 00000000 59 
15-OCT 10:51:53.538331 03 81F75980 PCB$00000429 8017A808 SCHSQUEUE AST CURRENT C+000F8 00000000 56 
15-OCT 10:51:53.597448 03 818BBE00 POOL 8004B334 EXESALONPAGVAR C+002F4 00000000 52 
15-OCT 10:51:53.670228 03 818BBE00 POOL 8004B334 EXESALONPAGVAR C+002F4 00000000 51 
Long Spinlock Wait Times (> 50 microseconds) (6) 

Timestamp CPU Spinlock | Forklock Calling PC | Forking PC EPID Wait (us) 
15-OCT 10:51:53.454082 03 818BCB00 FILSYS 800FC508 IOC_STD$MAPVBLK_C+000C8 00000000 79 
15-OCT 10:51:53.661343 02 818BCB00 FILSYS 8021B208 FINISH REQUEST C+00058 00000000 76 
15-OCT 10:51:53.661256 00 818BCB00 FILSYS 8021EDD0 F11BXQP+08DD0 00000000 66 
15-OCT 10:51:53.898618 00 818BCB00 FILSYS 8021B06C START REQUEST C+0006C 00000000 53 


This example shows the output of the SPL ANALYZE command, which is divided 
into several sections: 


1. 


Spinlock Analysis: 


Shows information on the platform such as the hardware type, the number of 
CPUs and the speed of the CPUs. 


CPU Statistics: 


Shows spinlock information on a per CPU basis. The percentage of time the 
CPU owns spinlock is displayed along with a percentage of time the CPU was 
executing from the fork dispatcher. This information can be very useful in 
determing the amount of time a CPU is in use for processing I/O. 


Spinlock Usage: 


Shows information on the spinlock usage by the system. This data is sorted 
by the percentage of time the spinlocks are held. The average hold time 
displayed is in system cycles. The display also includes the percent of time 
that CPUs are waiting on this spinlock along with the average number of 
cycles a CPU needed to wait before it was able to acquire the spinlock. 


Spinlock: 


For each spinlock displayed in section 3, the top callers are displayed sorted 
by the number of acquires per second that occurred. In addition, the average 
hold and wait time for each caller is displayed in system cycles. 


Long Spinlock Hold Times: 


The section on Long Spinlock Hold Times shows occurrences of spinlocks 
whose hold time exceeded a threshold. In the above report, the threshold 
was specified as 50 microseconds. The EPID at the time of the acquire is also 
displayed. An EPID of 0 indicates that the spinlock acquire did not occur in 
process context. 


Long Spinlock Wait Times: 


The section on Long Spinlock Wait Times shows occurrences of spinlocks 
whose wait time exceeded a threshold. In the above report, the threshold 
was specified as 50 microseconds. The EPID at the time of the acquire is also 
displayed. An EPID of 0 indicates that the spinlock acquire did not occur in 
process context. 
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SPL LOAD 
SPL LOAD 
Loads the SPL$DEBUG execlet. This must be done prior to starting spinlock 
tracing. 
Format 
SPL LOAD 
Parameters 
None. 
Qualifiers 
None. 


Description 


The SPL LOAD command loads the SPL$DEBUG execlet, which contains the 
tracing routines. 


Example 


SDA> SPL LOAD 
SPLSDEBUG load status = 00000001 
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SPL SHOW COLLECT 


SPL SHOW COLLECT 


Displays the collected spinlock data. 


Format 
SPL SHOW COLLECT [/RATES|/TOTALS] 

Parameters 
None. 

Qualifiers 
/RATES 
Reports activity as a rate per second and hold/spin time as a percentage of time. 
This is the default. 
TOTALS 
Reports activity as a count and hold/spin time as cycles. 

Description 
The SPL SHOW COLLECT command displays the collected spinlock data. It 
displays first a summary on a per-CPU basis, followed by the callers of the 
specific spinlock. This second list is sorted by the top consumers of the spinlock 
(in percent of time held). These displays show average spinlock hold and spinlock 
wait time in system cycles. 

Example 


SDA> SPL SHOW COLLECT 


Spinlock Trace Information for SCHED: 


Spin to 

CPU ID % Time Held Acquires/sec Average Hold % Time Spinning Waits/sec Average Spin Hold Ratio 

08 4.6 1651.4 8296 0.3 298.2 2601 0.06 

09 4.9 1941.8 7578 0.2 276.3 1841 0.03 

10 4.0 1593.5 7454 0.1 225.4 1794 0.03 

11 5.2 2185.6 7185 0.2 272.8 1924 0.03 

12 5.4 2105.1 7702 0.2 271.3 2012 0.03 

13 5.7 6131.5 2785 2.5 2288.8 3330 0.45 

29.7 15608.8 6833 3.5 3632.8 2250 0.12 

Spinlock Trace Information for SCHED: ( 6-DEC-2001 09:01:52.26, 3.3 nsec, 300 MHz) 

% Time Acquires Spinwaits Average % Time 
Caller's PC Held /sec Maximum Minimum Average /sec Spinwait Spin 
80342384 LCKS$SND_CVTREQ_C+00344 17.1 5758.4 26384 3531 8912 65.7 3181 0.1 
8012D53C SCHSIDLE_C+0024C 53 2614.5 20897 1384 6134 1083.3 1524 0.5 
80347BB0 LCK$DEALLOC_LKB C+00220 Bid 5880.6 7767 472 2641 2248.5 3332 2.5 
80151F84 SCHSINTERRUPT+00064 0.5 214.1 15564 1619 6895 35.3 6092 0.1 
80343FB8 LCK$SND_LOCKREQ C+00148 0.4 137.8 24063 4716 9509 0.0 0 0.0 
801375C0 SCHSQEND_C+00080 0.3 228.9 12107 2474 4251 29.0 3315: 0.0 
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SPL SHOW TRACE 


SPL SHOW TRACE 


Displays spinlock tracing information. 


Format 
SPL SHOW TRACE _ [/[NO]SPINLOCK=spinlock | /[NO]JFORKLOCK=forklock 
|/[NOJACQUIRE |/RATES |/[NO]RELEASE |/[NO]WAIT 
|/[NO]JFRKDSPTH | /[NOJFRKEND 
|/SUMMARY |/CPU=n |/TOP=n|/TOTALS] 
Parameters 
None. 
Qualifiers 


/SPINLOCK=spinlock 

/NOSPINLOCK 

The /SPINLOCK=n qualifier specifies the display of a specific spinlock, for 
example, /SPINLOCK=LCKMGR or /SPINLOCK=SCHED. 


The /NOSPINLOCK qualifier specifies that no spinlock trace information be 
displayed. If omitted, all spinlock trace entries are decoded and displayed. 


/FORKLOCK=forklock 

/NOFORKLOCK 

The /FORKLOCK=/orklock qualifier specifies the display of a specific forklock, for 
example, /FORKLOCK=IOLOCK8 or /FORKLOCK=IPL8. 


The /NOFORKLOCK qualifier specifies that no forklock trace information be 
displayed. If omitted, all fork trace entries are decoded and displayed. 


/ACQUIRE 
/NOACQUIRE 
The /ACQUIRE qualifier displays any spinlock acquisitions. 


The /NOACQUIRE qualifier ignores any spinlock acquisitions. 
/RATES 


Reports activity as a rate per second and hold/spin time as a percentage of time. 
This is the default. 


/RELEASE 
/NORELEASE 
The /RELEASE qualifier displays any spinlock releases. 


The /NORELEASE qualifier ignores any spinlock releases. 


TOTALS 
Reports activity as a count and hold/spin time as cycles. 


/WAIT 
/NOWAIT 
The /WAIT qualifier displays any spinwait operations. 


The /NOWAIT qualifier ignores any spinwait operations. 


SDA Spinlock Tracing Utility (SPL) 8-9 


SDA Spinlock Tracing Utility (SPL) 
SPL SHOW TRACE 


/FRKDSPTH 

/NOFRKDSPTH 

The /FRKDSPTH qualifier displays all invocations of fork routines within the fork 
dispatcher. This is the default. 


The /NOFRKDSPTH qualifier ignores all of the operations of the /FRKDSPTH 
qualifier. 


/FRKEND 

/NOFRKEND 

The /FRKEND qualifier displays all returns from fork routines within the fork 
dispatcher. This is the default. 


The /NOFRKEND qualifier ignores all operations of the /FRKEND qualifier. 


/CPU=n 
Specifies the display of information for a specific CPU only, for example, /CPU=5 
or /CPU=PRIMARY. By default, all trace entries for all CPUs are displayed. 


/SUMMARY 
Steps through the entire trace buffer and displays a summary of all spinlock and 
forklock activity. It also displays the top ten callers. 


/TOP=n 
Displays a different number other than the top ten callers or fork PCs. By 


default, the top ten are displayed. This qualifier is only useful when you also 
specify the /SUMMARY qualifier. 


Description 


The SPL SHOW TRACE command displays spinlock tracing information. The 
latest acquired or released spinlock is displayed first, and then the trace buffer is 
stepped backwards in time. 


By default, all trace entries will be displayed, but you can use qualifiers to select 
only certain entries. 


Since this is not a time critical activity and a table lookup has to be done 
anyway to translate the SPL address to a spinlock name, commands like 
/SPINLOCK=(SCHED,IOLOCK8) do work. /SUMMARY will step the entire 
trace buffer and display a summary of all spinlock activity, along with the top-ten 
callers’ PCs. You can use /TOP=n to display a different number of the top ranked 
callers. 
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1.Spinlock Trace Information: 


Examples 


SDA Spinlock Tracing Utility (SPL) 
SPL SHOW TRACE 


EPID Operation 


Trace Buffer 


+223052 
+ 794732 
-307011 
-307497 
- 306490 
-307951 
- 818853 
- 819422 
- 819374 
- 818851 
- 820320 
- 819370 
819415 
- 820316 
- 820314 
+ 820312 
-819409 


810B2200 
810B2900 
810B2200 
810B2100 
810B2200 
810B2200 
810B2200 
810B2100 
810B2100 
810B2200 
810B2100 
810B2700 
810B2100 
8994FE00 
810B2200 
810B2200 
810B2100 


80175594 
800F4340 
8017B154 
80144770 
8017550C 
80175D9C 
80175594 
8011F53C 
8014COE8 
8017550C 
801473A0 
800FFB30 
8011F370 
80146Fr44 
80175DC0 
80175D9C 
8014C0E8 


MMG_STDSIOLOCK_BUF_C+00214 
IOC_STD$MAPVBLK_C+002A0 
SYSSVM+17154 
PROCESS_MANAGEMENT+2A770 
MMG_STD$IOLOCK_BUF_C+0018C 
MMG_STD$IOUNLOCK_BUF_C+000 
MMG_STDSIOLOCK_BUF_C+00214 
SCHS$CALC_CPU_LOAD_C+0049C 
EXESSYNCH_LOOP_C+00458 
MMG_STD$IOLOCK_BUF_C+0018C 
SCHSQAST_C+004F0 
EXE_STDSINSIOQ_C+002B0 
SCHSCALC_CPU_LOAD_C+002D0 
SCHSQAST C+00094 
MMG_STD$IOUNLOCK_BUF_C+000 
MMG_STD$IOUNLOCK_BUF_C+000 
EXESSYNCH_LOOP_C+00458 


00000568 Release 
0000056E Restore 
00000570 Release 
00000000 Release 
00000571 Acquire 
00000000 Acquire 
00000571 Release 
00000000 Acquire 
00000570 Acquire 
00000571 Acquire 
00000000 Acqnoipl 
00000570 Release 
00000000 Release 
00000000 Acquire 
00000000 Restore 
00000000 Acquire 
QO00056F Acquire 


(nospin) 


FFFFFFFE. 
FEFFFFFFE. 
FFFFFFFE. 
FFFFFFFE. 
FFFFFFFE. 
FFFFFFFE. 
FFFFFFFE. 
FFFFFFFE. 
FFFFFFFE. 
FFFFFFFE. 
FFFFFFFE. 
FFFFFFFE. 
FFFFFFFE. 
FEFFFFFFE. 
FFFFFFFE. 
FEFFFFFE. 
FEFFFFFE. 


O5F635E0 
O5F635C0 
O5F635A0 
05F63580 
05F63560 
05F63540 
05F63520 
05F63500 
O5F634E0 
O5F634C0 
O5F634A0 
05F63480 
05F63460 
05F63440 
05F63420 
05F63400 
O5F633E0 
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Callout Meaning 


1 


Shows timestamps that are collected as system cycle counters (SCC) 
and then displayed with an accuracy down to microseconds. Each CPU 
is incrementing its own SCC as soon as it is started, so there is some 
difference between different CPUs’ system cycle counters. The standard 
system time is incremented only every 10 Msec and as such is not 
exact enough. Adjusting the SCC to the specific CPU’s system time and 
translating it into an accurate timestamp will thus sometimes display 
times out of order for different CPUs. However, for the same CPU ID, 
the timestamps are accurate. 


Shows the physical CPU ID of the CPU logging the trace entry. 


Shows the address of the spinlock fork. If it is a static one, its name is 
displayed; otherwise, it is marked as ???. 


Shows the caller’s PC address that acquired or released the spinlock, or 
the fork PC if the trace entry is a forklock. Symbolization is attempted, 
so a READ/EXECUTIVE might help to display a routine name, instead 
of simply a module and offset. 


Shows the EPID, which is the external PID of the process generating the 
trace entry. If an interrupt or fork was responsible for the entry, then a 
zero EPID is displayed. 


Shows the trace operation. For a spinlock, which was acquired without 
going through a spinwait, there is a matching acquire/release pair of 
trace entries for the same CPU ID for a given spinlock. If a spinlock 
is held, it cannot be acquired immediately, so there is also a spinwait 
trace entry for this pair. The different variations of the acquire and 
release operations are distinguished, as are the same spinlocks if they 
are acquired recursively multiple times. 


Shows the address of the trace buffer entry, in case there is a need to 
access the raw and undecoded trace data. 
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SPL SHOW TRACE 


SDA> SPL SHOW TRACE/SUMMARY 8 } 


Spinlock Trace Information: (at 6-DEC-2001 09:01:47.02, trace time 00:00:01.415159) 


Events Acquires Releases Acq Own Acq NoSpin Spinwaits & 

Spinlock /sec /sec /sec /sec /sec /sec Spinwait 
EMB 1.4 0.7 0.7 0.0 0.0 0.0 0.0 
MEGA 1.4 0.7 0.7 0.0 0.0 0.0 0.0 
HWCLK 2049.2 1024.6 1024.6 0.0 0.0 0.0 0.0 
INVALIDATE 221.9 110.9 110.9 0.0 0.0 0.0 0.0 
MAILBOX 4.2 2.1 2.1 0.0 0.0 0.0 0.0 
SCHED 34851.2 15609.6 15608.8 0.0 0.0 3632.8 23.3 
MMG 1776.5 781.5 888.2 12.7 94.0 0.0 0.0 
TIMER 308.1 154.0 154.0 0.0 0.0 0.0 0.0 
TX_SYNCH 57.9 29.0 29.0 0.0 0.0 0.0 0.0 
IOLOCK8 33944.6 15285.9 15292.3 6.4 0.0 3360.0 22.0 
LCKMGR 53421.6 17816.4 17843.2 0.0 28.3 17733.7 99.4 
FILSYS 278.4 139.2 139.2 0.0 0.0 0.0 0.0 
QUEUEAST 5.7 2.8 2.8 0.0 0.0 0.0 0.0 
22? 41312.0 20538.3 20655.6 0.0 117.3 0.7 0.0 
168234.1 71495.8 71752.4 19.1 239.5 24727.3 34.5 


Spinlock Trace Information: @ 


Events Acquires or Spins & Own 
Spinlock /sec Releases/sec /sec Caller's PC Module Offset 


SCHED 8129.1 5880.6 Acq/s 2248. 


5 38.2 0.0 80347BB0 LCK$DEALLOC_LKB_C+00220 SYSSCLUSTER 00027BBO 
SCHED 6186.6 6186.6 Rel/s 0.0 0.0 0.0 80152668 SCHSINTERRUPT+00748 PROCESS MANAGEMENT 0002A668 
SCHED 5880.6 5880.6 Rel/s 0.0 0.0 0.0 80347C24 LCKSDEALLOC_LKB C+00294 SYSSCLUSTER 00027C24 
SCHED 5824.1 5758.4 Acq/s 65.7 Lok 0.0 80342384 LCKSSND_CVTREQ_C+00344 SYSSCLUSTER 00022384 
SCHED 3697.8 2614.5 Acq/s 1083.3 41.4 0.0 8012D53C SCHSIDLE_C+0024C PROCESS MANAGEMENT 0000553Cc 
SCHED 2614.5 2614.5 Rel/s 0.0 0.0 0.0 8012D370 SCHSIDLE_C+00080 PROCESS MANAGEMENT 00005370 
SCHED 444.5 368.9 Acq/s 1Ss& 20.5: 0.0 80157E10 SCHS$POSTEF_C+00050 PROCESS MANAGEMENT 0002FE10 
SCHED 368.9 368.9 Rel/s 0.0 0.0 0.0 80157A70 SCH$POSTEF_SCHED_C+00140 PROCESS MANAGEMENT 0002FA70 
SCHED 258.6 229.7 Acq/s 29.0 12.6 0.0 801375C0 SCHSQEND_C+00080 PROCESS MANAGEMENT 0000F5CO 
SCHED 249.4 214.1 Acq/s 35.3 16.5 0.0 80151F84 SCHSINTERRUPT+00064 PROCESS MANAGEMENT 00029F84 
MMG 154.8 154.8 Acq/s 0.0 0.0 0.0 80186AA4 MMGSPAGEFAULT_C+000A4 SYSSVM 00014AA4 
MMG 106.7 106.7 Acq/s 0.0 0.0 0.0 8017E658 MMG_STD$SET_GH_AND_FASTMAP_6 SYS$VM 0000c658 
MMG 106.7 106.7 Rel/s 0.0 0.0 0.0 8017E68C MMG_STD$SET_GH_AND FASTMAP 6 SYS$VM 0000c68c 
MMG 88.3 88.3 Rel/s 0.0 0.0 0.0 80187024 MMGS$PAGEFAULT_C+00624 SYSSVM 00015024 
MMG 77.7 77.7 Rel/s 0.0 0.0 0.0 8019F904 MMG STDSSETPRTPAG_64 C+002C4 SYSSVM 0002C904 
continued 
VM-0676A-Al 
Callout Meaning 
8 Shows the summary information by stepping through the whole trace 


buffer, and displaying a single line of information for each spinlock. If 
the percent of spin wait is very high, then a spinlock is a candidate for 
high contention. 


9 For each spinlock in the summary display, the top ten callers’ PCs are 
displayed along with the number of spinlock acquisitions and releases, as 
well as spinwait counts and the number of multiple acquisitions of the 
same spinlock. 
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SPL SHOW TRACE 


Forklock Trace Information: (at 6-DEC-2001 09:01:47.02, trace time 00:00:01.415159) @) 


Forklock 


QUEUEAST 


Totals 


Total 
Events/sec 


Forklock Trace Information: 


Forklock 


Totals 


IOLOCK8 
IOLOCK8 


Totals 


LCKMGR 


Totals 


QUEUEAST 


Totals 


Event/sec 


a 
w 
w 
eI 


35812 


6732 
7619 


18268 


24885 


Minimum 


504 


491 
1224 


3933 


20589 


Maximum 


813332 


24046 
28993 


64563 


32203 


Fork PC 


803F1490 


80050050 


805C4840 
805EEEC8 


8032E5E0 


802E4370 


SYSSPCADRIVER+05490 


EXE$SWTIMER_FORK_C 


SYSSEWDRIVER+04840 
EXEC .FORK_C+00080 


CNX$RCV_MSG_LCKMGR_FRK_C 


XFCCOMMONFORKDISPATCH_C 
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Callout Meaning 


10 


The forklock summary displays the number of fork operations on a 
specific CPU for each forklock. For each forklock, the top ten fork 

PC addresses are displayed, along with the minimum, maximum and 
average duration of the fork operation in system cycles. The percent of 
time spent in a given fork routine is displayed along with the percent of 
time for the forklock. 
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SPL START COLLECT 


SPL START COLLECT 


Format 


Parameters 


Qualifiers 


Description 


Examples 


Starts to collect spinlock information a longer period of time than will fit into the 
trace buffer. 


SPL START COLLECT  [/SPINLOCK=spiniock|/ADDRESS=n] 


None. 


/SPINLOCK=spinlock 
Specifies the tracing of a specific spinlock, for example, /SPINLOCK=LCKMGR or 
/SPINLOCK=SCHED. 


/ADDRESS=n 
Specifies the tracing of a specific spinlock by address. 


The SPL START COLLECT command starts a collection of spinlock information 
for a longer period of time than will fit into the trace buffer. You need to enable 
spinlock tracing before a spinlock collection can be started. On a system with 
heavy activity, the trace buffer typically can only hold a relatively small time 
window of spinlock information. In order to collect spinlock information over a 
longer time period, a collection can be started. The collection tries to catch up 
with the running trace index and save the spinlock information into a balanced 
tree within the virtual address space of the process performing the spinlock 
collection. Either use the name of a static spinlock, or supply the address of a 
dynamic spinlock, for which information should be gathered. 


The trace entries are kept in the trace buffer, which is allocated from S2 space, 
hence there is no disruption, if tracing is started from within SDA and then 

the user exits from SDA. However, for the longer period data collection, the 
information is kept in process-specific memory, thus a user needs to stay within 
SDA; otherwise the data collection is automatically terminated by SDA’s image 
rundown. You can collect data for two or more spinlocks simultaneously, by using 
a separate process for each collection. 


1. SDA> SPL START COLLECT 
Use /SPINLOCK=name or /ADDRESS=n to specify which spinlock info needs to be collected... 


This example shows that you need to supply either a spinlock name of a static 
spinlock, or the address of a dynamic spinlock, if you want to collect information 
over a long period of time. 


2. SDA> SPL START COLLECT/SPINLOCK=LCKMGR 


This example shows the command line to start to collect information on the usage 
of the LCKMGR spinlock. 
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SPL START TRACE 


SPL START TRACE 


Format 


Parameters 


Qualifiers 


Enables spinlock tracing. 


SPL START TRACE [/[NO]JSPINLOCK=spinlock | /[NO]FORKLOCK=forklock 
| /BUFFER=pages | /[NO]ACQUIRE | 
|/[NO]RELEASE | /[NO]WAIT | /[NO]JFRKDSPTH 
| /[NO]JFRKEND | /CPU=n] 


None. 


/SPINLOCK=spinlock 

/NOSPINLOCK 

The /SPINLOCK=spinlock qualifier specifies the tracing of a specific spinlock, for 
example, /SPINLOCK=LCKMGR or /SPINLOCK=SCHED. 


The /NOSPINLOCK qualifier disables spinlock tracing and does not collect any 
spinlock data. If omitted, all spinlocks are traced. 


/FORKLOCK=forklock 

/NOFORKLOCK 

The /FORKLOCK=/orklock qualifier specifies the tracing of a specific forklock, for 
example, /FORKLOCK=IOLOCK8 or /FORKLOCK=IPL8. 


The /NOFORKLOCK qualifier disables forklock tracing and does not collect any 
forklock data. If omitted, all forks are traced. 


/BUFFER=pages 
Specifies the size of the trace buffer (in page units). It defaults to 128 pages, 
which is equivalent to 1MB, if omitted. 


/ACQUIRE 
/NOACQUIRE 
The /ACQUIRE qualifier traces any spinlock acquisitions. This is the default. 


The /NOACQUIRE qualifier ignores any spinlock acquisitions. 


/RELEASE 
/NORELEASE 
The /RELEASE qualifier traces any spinlock releases. This is the default. 


The /NORELEASE qualifier ignores any spinlock releases. 


/WAIT 
/NOWAIT 
The /WAIT qualifier traces any spinwait operations. This is the default. 


The /NOWAIT qualifier ignores any spinwait operations. 
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SPL START TRACE 


/FRKDSPTH 

/NOFRKDSPTH 

The /FRKDSPTH qualifier traces all invocations of fork routines within the fork 
dispatcher. This is the default. 


The /NOFRKDSPTH qualifier ignores all of the /FRKDSPTH operations. 


/FRKEND 

/NOFRKEND 

The /FRKEND qualifier traces all returns from fork routines within the fork 
dispatcher. This is the default. 


The /NOFRKEND qualifier ignores all of the operations of the /FRKEND qualifier. 


/CPU=n 
Specifies the tracing of a specific CPU only, for example, /CPU=5 or 
/CPU=PRIMARY. By default, all CPUs are traced. 

Description 


The SPL START TRACE command enables spinlock and fork tracing. By default 
all spinlocks and forks are traced and a 128 page (1MByte) trace buffer is 
allocated and used as a ring buffer. 


Examples 


1. SDA> SPL START TRACE/BUFFER=1000 
Tracing started... (Spinlock = 00000000, Forklock = 00000000) 


This example shows how to enable a tracing for all spinlock and forklock 
operations into a 8 MByte trace buffer. 


2. SDA> SPL START TRACE/CPU=PRIMARY/SPINLOCK=SCHED /NOFORKLOCK 
Tracing started... (Spinlock = 810AF600, Forklock = 00000000) 


This example shows how to trace only SCHED spinlock operations on the 
primary CPU. 


3. SDA> SPL START TRACE /NOSPINLOCK /FORKLOCK=IPL8 
Tracing started... (Spinlock = 00000000, Forklock = 863A4C00) 


This example shows how to trace only fork operations to IPL8. 
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SPL STOP COLLECT 


SPL STOP COLLECT 


Stops the spinlock collection, but does not stop spinlock tracing. 


Format 

SPL STOP COLLECT 
Parameters 

None. 
Qualifiers 

None. 


Description 


The SPL STOP COLLECT command stops the data collection, but does not affect 
tracing. This allows the user to start another collection for a different spinlock 
during the same trace run. 


Example 


SDA> SPL STOP COLLECT 
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SPL STOP TRACE 


SPL STOP TRACE 


Disables spinlock tracing, but it does not deallocate the trace buffer. 


Format 

SPL STOP TRACE 
Parameters 

None. 
Qualifiers 

None. 


Description 


The SPL STOP TRACE command stops tracing, but leaves the trace buffer 
allocated for further analysis. 


Example 


SDA> SPL STOP TRACE 
Tracing stopped... 
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SPL UNLOAD 


SPL UNLOAD 


Format 


Parameters 


Qualifiers 


Description 


Example 


Unloads the SPL$DEBUG execlet and performs cleanup. Tracing is automatically 
disabled and the trace buffer deallocated. 


SPL UNLOAD 


None. 


None. 


The SPL UNLOAD command disables the tracing or collection functionality with 
a delay to a state of quiescence. This ensures that all pending trace operations 
in progress have finished before the trace buffer is deallocated. Finally the SPL 
UNLOAD command unloads the SPL$DEBUG execlet. 


SDA> SPL UNLOAD 
SPLSDEBUG unload status = 00000001 
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SDA Extended File Cache Extension (XFC) 


This chapter describes the SDA extension commands for the Extended File Cache 
(XFC). 


9.1 Overview of SDA XFC Extensions 


The SDA extension commands for Extended File Cache (XFC) enable you to 
perform the following tasks: 


e Display, in a convenient and readable format, various XFC data structures 


e Display, in a convenient and readable format, statistics that aid in tuning the 
extended file cache 


9.2 SDA XFC Commands List 


The section describes the SDA XFC extension commands: 


EXIT 

LOAD DSF 

SHOW CONTEXT 
SHOW EXTENT 
SHOW FILE 
SHOW MEMORY 
SHOW SUMMARY 
SHOW TABLES 
SHOW TRACE 
SHOW VOLUME 


Commands can be entered at the SDA prompt. For example: 
SDA> XFC SHOW SUMMARY 


Alternatively, the XFC extension can be invoked without a command, in which 
case the XFC extension prompts for commands. For example: 


SDA> 

XFC> SHOW SUMMARY 
XFC> EXIT 

SDA> 


Note that if this alternative approach is used and the output from a command 
does not fit on one screen, the screen overflow prompt remains an SDA prompt 
and accepts SDA commands, not XFC commands. See Section 2.6.2 for an 
explanation of the screen overflow prompt. 
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EXIT 
EXIT 
Exits the XFC SDA extension. 
Format 
EXIT 
Parameters 
None. 
Qualifiers 
None. 


Description 


The EXIT command issued from the SDA> prompt exits you from SDA to the 
DCL ($) prompt. If you invoke XFC at the SDA> prompt, you receive an XFC> 
prompt, from which you can then invoke a specific command, for example, SHOW 
SUMMARY. If you invoke EXIT at the XFC> prompt, you are returned to the 


SDA> prompt. 


Example 


SDA> XFC 
XFC> SHOW SUMMARY 


XFC Summary 

Extended File Cache V1.0 (May 6 2002 11:33:46) 
Anchor Block Address: FFFFFFFF80D30410 
Build Id: 

Cache State: 0000A010 

Cache in no-cache state: False 


XFC>EXIT 
SDA> 


This command shows the procedure for exiting from the XFC extension. 
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SDA Extended File Cache Extension (XFC) 
LOAD DSF 


LOAD DSF 


Loads the symbols in the specified debug symbol file (DSF) for use with the SDA 
FORMAT command. 

Format 
LOAD DSF filename 


Parameter 

filename 

The name of the symbol file. 
Qualifiers 


None. 


Description 


The LOAD DSF command loads the symbol tables for the XFC internal data 
structures. The XFC symbol tables are contained in a file SYS$XFCACHE.DSF, 
which is located in the system directory, SYS$LOADABLE_IMAGES. This 
command is not available on OpenVMS I64. 
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SDA Extended File Cache Extension (XFC) 
LOAD DSF 


Example 


SDA> XFC SHOW FILE/BRIEF 
XFC Cache File Block brief listing 


CFB Address CVB Address Volume Name File ID Access 
FFFFFFFD83120D40 FFFFFFFD831FA080 DISKSFRROOG_RUBY (541,5,0) 0 


SDA> FORMAT FFFFFFFD83120D40 

SSDA-E-NOSYMBOLS, no "VCC CFB" symbols found to format this block 
DA> xfc load dsf sysSloadable images:sys$xfcache 

Reading symbols from SYSS$SYSROOT: [ SYS$LDR]SYSS$XFCACHE.DSF;21 


Loaded 825 symbols> 
SDA> FORMAT FFFFFFFD83120D40 


FFFFFFFD.83120D40 | CFBSR PSNOLDHEADER 00000001 
FFFFFFFD.83120D44 ~ 00000001 
FFFFFFFD.83120D48 § CFBSW UWMUSTBEONE 0001 
FFFFFFFD.83120D4A CFBSB BTYPE 6F 
FFFFFFFD.83120D4B  CFBSB BSUBTYPE 40 
FFFFFFFD.83120D4C CFBSR PFCBFILE 81935900 
FFFFFFFD.83120D50 CFBSQ UQSIZE 0000021c 
FFFFFFFD.83120D54 ~ 00000000 
FFFFFFFD.83120D58 | CFBSR PCVBCACHEVOLUME 831FA080 
FFFFFFFD.83120D5C ~ FFFFFFFD 
FFFFFFFD.83120D60 | CFBSR QHDQUEUEHEAD 83120B40 
FFFFFFFD.83120D64 > FFFFFFFD 
FFFFFFFD.83120D68 83121800 


FFFFFFFD.83120D6C FFFFFFFD 


This example shows the output of loading symbols from the XFC debug symbols 
file, and using those symbols to format a CFB structure. 
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SDA Extended File Cache Extension (XFC) 
SHOW CONTEXT 


SHOW CONTEXT 


Displays the contents of an XFC context block (CTX). 


Format 
SHOW CONTEXT _[address][/STALLING | /FULL | /BRIEF] 

Parameter 
address 
The address of the CTX. If no address is supplied, then all the context structures 
are displayed. 

Qualifiers 
/BRIEF 
Displays a brief summary for each context; for example, the I/O type, start virtual 
block number (VBN), and length of I/O. 
/FULL 
Displays the complete context structure. This is the default. 
/STALLING 
Displays only contexts that are stalling; for example, those that have a stall 
reason code other than estrNotStalling. 

Description 
The SHOW CONTEXT command displays the contents of an active context block. 
The state of each active operation within XFC is maintained in a data structure 
called a context block. 

Examples 


1. SDA> XFC SHOW CONTEXT/BRIEF 


List of All XFC Active Contexts (CTX) 


Address I/O Type I/O phase I/O Stall reason Volume ID File ID Start VBN Length IRP 
FFFFFFFF818C6250 eiotReadThrough eiopFillcontext estrWindowTurn FFFFFFFD8311BD00 3156 382593 32 818F7780 
FFFFFFFF81854D10 eiotReadThrough eiopFillcontext estrWindowTurn FFFFFFFD8311BD00 3156 283873 32 81B26940 
FFFFFFFF818787D0 eiotReadThrough eiopFillContext estrWindowTurn FFFFFFFD8311BD00 3156 351777 32 81265FCO 
FFFFFFFF81849E50 eiotReadAround eiopSegmentDone estrDiskIO FFFFFFFD8311BD00 3156 289089 32 818F7540 
FFFFFFFF818DC0DO eiotReadAround eiopSegmentDone estrDiskIO FFFFFFFD8311BD00 3156 271809 32 817C1800 
FFFFFFFF81854190 eiotClusterTrans eiopClusterIdle estrNotStalled 0000000000000000 0 0 0 00000000 


Contexts found: 6 


This example shows the address of the context block, I/O type (the type of 


VM-1055A-Al 


operation), I/O phase (what phase the operation is in), I/O stall (reason for its 
stalling), volume ID (address of the control volume block), start VBN (starting 
VBN of the I/O), length of the I/O, and I/O request packet (the address of the 


IRP). 
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SDA Extended File Cache Extension (XFC) 
SHOW CONTEXT 


2. SDA> XFC SHOW CONTEXT FFFFFFFF8190D690 
List of All XFC Active Contexts (CTX) 


Context (CTX) Address: FFFFFFFF8190D690 


I/O Phase: eiopFillContext 
I/O Type: eiotReadThrough 
Operation started: 17-APR-2002 11:23:29.00 
Stall Reason: estrWindowTurn 
Stall Extent: 0000000000000000 
Stall Op (IRP): FFFFFFFF81267A40 
Saved AST Parameter: 0000000000000000 
Restart Routine: 0000000000000000 
Context state flags 00000000 

Cache Hit: False 

HWM Checked: False 

Fork Restarted False 

AST Required (flush) False 

Buffer locked False 

Stalled converting False 

Fork Block in use False 


Override resource checks False 


Restart cluster trans False 

Restart cluster flush False 

MV volumes skipped False 

Depose pending False 

Ignore CFB Quiesce False 

Delete CFB False 

Read-ahead hit False 
ECB Count: 0 
Index: 00000000 ( 0) 
Start VBN: 000107C1 ( 67521) 
Length in Blocks: 00000020 ( 32) 
Next VBN: 000107C1 ( 67521) 
I/O Extent Count: 0 
Disk I/0 Length: 00000020 ( 32) 
Bytes Copied: 0 
Bytes Zeroed: 0 
Bytes Requested: 16384 
Volume (CVB): 0000000000000000 
Volume Id: FFFFFFFD8311BD00 
File Id: 0000000000000C54 
Cache File Block: FFFFFFFD82CEA2A0 
Process (PCB): FFFFFFFF818FA500 


This example shows output of a full display of a context block for a read I/O. 
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SDA Extended File Cache Extension (XFC) 
SHOW EXTENT 


SHOW EXTENT 


Displays the contents of an extent control block (ECB). 


The SHOW EXTENT command diplays the contents of an extent control block 
(ECB). The data in the cache is divided into groups of VBNs called extents. Each 
extent is maintained in a data structure called an extent control block. 


Format 

SHOW EXTENT address 
Parameter 

address 

The address of the ECB. 
Qualifiers 

None. 
Description 
Example 


SDA> XFC SHOW EXTENT FFFFFFFD82A58A20 


Cache Extent Address: 
Type: 
Flink: 
Blink: 
Start VBN: 
Start LBN: 
Length in Blocks: 
Data State: 
Pin: 
Buffer Address: 
Secondary ECB Queue: 
Flink: 
Blink: 
Primary ECB: 
LRU Queue: 
Flink: 
Blink: 
Waiters Queue: 
Flink: 
Blink: 
Lock Id: 
Parent CFB: 
ECB delete pending 
ECB on LRU queue 
ECB depose pending 
ECB read ahead 
LRU priority: 


FFFFFFFD82A58A20 
Primary 
FFFFFFFF7F880350 
FFFFFFFF7F880350 
00000001 ( a 
QOBA711C ( 12218652) 
00000006 ( 6) 
Clean 
None 
FFFFFFFDB0996000 
FFFFFFFD82A58A60 
FFFFFFFD83199A20 
FFFFFFFD83199A20 
0000000000000000 
FFFFFFFD82A58AAC 
FFFFFFFD82A5A26C 
FFFFFFFD82A5344C 
FFFFFFFD82A58A50 
FFFFFFFD82A58A50 
FFFFFFFD82A58A50 
00000000 
FFFFFFFD82A61180 
False 
True 
False 
False 
1 


This example shows the contents of an extent control block. 
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SDA Extended File Cache Extension (XFC) 


SHOW FILE 


SHOW FILE 


Format 


Parameter 


Qualifiers 


Displays the contents of the cache file block (CFB). 


SHOW FILE [address] [/EXTENTS | /ID=file-id 
| /CVB=address |/OPEN|/CLOSEDI/STATISTICS |/FULL 
| /BRIEF] 


address 
The address of the CFB. The /OPEN and /CLOSED qualifiers, if present, are 
ignored. If no address is supplied, then all the CFBs are displayed. 


/BRIEF 
Displays summary information for each cache file block (CFB), such as the CFB 
address, cache volume block (CVB) address, access count, active I/O count, and 
file ID. 


/CLOSED 
Displays only CFBs whose access count is zero. 


/CVB=address 
Displays only information about any files matching the given cache volume block 
address. 


/EXTENTS 

Displays the cache extents held in cache for any displayed files. This shows the 
primary and secondary cache extents along with their data state and virtual block 
numbers (VBNs). It also shows a summary of memory usage (pagelets used and 
pagelets valid) for any displayed files. The /EXTENTS qualifier is incompatible 
with the /BRIEF qualifier. 


/FULL 
Displays all fields for each cache file block. This is the default. 


ND=file-id 

Displays only information about any files matching the given file-identification 
(FID). The file identification (FID) is the hexadecimal file number component in a 
format file ID (file number, sequence number, relative volume number). 


/OPEN 
Displays only CFBs whose access count is greater than zero. 


ISTATISTICS 
Displays more statistics about the specified file. The /STATISTICS qualifier is 
incompatible with the /BRIEF qualifier. 
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SDA Extended File Cache Extension (XFC) 
SHOW FILE 


Description 


The SHOW FILE command displays the contents of the XFC cache file block. The 
state of any file in the cache is maintained in a data structure called a cache file 
block (CFB). There is a CFB for every open file on a system and a CFB for each 


Examples 


closed file that is still being cached. 


1. SDA> XFC SHOW FILE/BRIEF 


XFC Cache File Block brief listing 


CFB Address CVB Address Volume Name File ID Access Write Total Read Hit Extent Allocated 
Count Access I/Os Hits Rate Count Pages 

FFFFFFFD831A24C0O FFFFFFFD831FE080 DISK$FRROOG_RUBY (899,4,0) 1 0 14 6 42.86% 13 13 
FFFFFFFD8319EF60 FFFFFFFD831FE080 DISK$FRROOG_RUBY (2098,4,0) 1 0 1 0 0.00% 1 1 
FFFFFFFD831E97EO FFFFFFFD831FE080 DISK$FRROOG_RUBY (2336,4,0) 1 0 10 3 30.00% 4 4 
FFFFFFFD831F3C20 FFFFFFFD831FE080 DISK$FRROOG_RUBY (423,4,0) 1 0 2 0 0.00% 3 3: 
FFFFFFFD831104C0O FFFFFFFD831FE080 DISK$FRROOG_RUBY (904,4,0) 1 0 6 0 0.00% 3 3 
FFFFFFFD831F04CO FFFFFFFD831FE080 DISK$FRROOG_RUBY (426,4,0) 1 0 2 0 0.00% 4 4 
FFFFFFFD8318FA00 FFFFFFFD831FE080 DISK$FRROOG_RUBY (2338,4,0) 1 0 141 101 71.63% 131 131 
FFFFFFFD831FE080 DISK$FRROOG_RUBY (427,4,0) 1 0 2 0 0.00% 4 4 


FFFFFFFD831F0080 


VM-1056A-Al 


This example shows the brief output from this command. 


2. SDA> XFC SHOW FILE/STATISTICS FFFFFFFD831A24C0 


Full Cache File Block ( 


CFB) Details 


CFB Address: FFFFFFFD831A24C0 
CFB Address: FFFFFFFD831A24C0 
Flink: FFFFFFFD831A22C0 
Blink: FFFFFFFD831A2700 
Access Count: 1 
Write Access Count: 0 
Volume (CVB): FFFFFFFD831FE080 
Quiescing: False 
File (FCB): FFFFFFFF81943D80 
Volume Id: FFFFFFFD831FE080 
File Id: 0000000000000383 
External FID: (899,4,0) 
Predicted Next VBN: OO0000FB ( 251) 
Active Caching Mode: Write Through 
Active I/O count: 0 
Flush Fail Status: 00000000 ( 0) 
No Readahead Reasons: 0 
Active Readaheads: 0 
File Bad: False 
Caching disabled: False 
File deleted on close: False 
File Quiescing: False 
File Deposing: False 
File Deleting: False 
File B1kASTInProg: False 
File IgnoreBl1kAST False 
File Readahead EOF False 
PECBs Allocated: 13 ( 13 pages) 
PECBs Deallocated: 0 
PECBs Deallocated: 0 
SECBs Allocated: 3 
SECBs Deallocated: 19 
Lock Id: 0C00037F 

Granted Lock mode: PRMode 
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SDA Extended File Cache Extension (XFC) 


SHOW FILE 
Conversion phase: Illegal 
Conversion phase count: 1 
Hash Bucket Queue: FFFFFFFD831A2520 
Flink: FFFFFFFF7FF819B0 
Blink: FFFFFFFF7FF819B0 
PECB Queue: FFFFFFFD831A2530 
Flink: FFFFFFFD8311888C 
Blink: FFFFFFFD831A072C 
Stalled I0s Queue: FFFFFFFD831A24F0 
Flink: FFFFFFFD831A24F0 
Blink: FFFFFFFD831A24F0 
FAL transition Queue: FFFFFFFD831A2500 
Flink: FFFFFFFD831A2500 
Blink: FFFFFFFD831A2500 
Contexts Waiting: FFFFFFFD831A2510 
Flink: FFFFFFFD831A2510 
Blink: FFFFFFFD831A2510 
BIkASTs Waiting: FFFFFFFD831A2540 
Flink: FFFFFFFD831A2540 
Blink: FFFFFFFD831A2540 
Deaccess Wait List: FFFFFFFD831A2600 
Flink: 0000000000000000 
Quiesce context: 0000000000000000 
Up convert context: 0000000000000000 


File IO Statistics - all in decimal 


Statistics Valid From: 


19-APR-2002 07:10:32.77 


Total QI0s to this file: 14 
Read I0s to this file: 14 
Write I0s to this file: 0 
Write I0s to this file: 0 
Read Hits: 6 
Hit Rate: 42.86 % 


Average Overall I/O response time to this file 
in milliseconds: 0.9525 

Average Cache Hit I/O response time to this file 
in milliseconds: 0.0702 

Average Disk I/O response time to this file 
in milliseconds: 1.6141 

Accuracy of I/O resp time: 65 % 

Read Ahead Count: 

Read Through Count: 1 

Write Through Count: 

Read Around Count: 

Write Around Count: 

CFB FAL stalls: 

CFB Operation stalls: 

FAL Blocking ASTs: 

Quiesce Depose: 

Quiesce depose Stalls: 


oOoOoOrRrCOCOOCOfS 


Oo 


(I/O size statistics not collected for this file) 


Files found: 1 


This example shows a collection of performance statistics for a file. 
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SDA Extended File Cache Extension (XFC) 
SHOW MEMORY 


SHOW MEMORY 


Displays information about memory used by the cache. 


Format 
SHOW MEMORY  [/BRIEF|/FULL] 
Parameters 
None. 
Qualifiers 
/BRIEF 
Displays summary statistics on XFC memory use. 
/FULL 
Displays full statistics on XFC memory use. This is the default. 
Examples 


1. SDA> XFC SHOW MEMORY 
XFC Memory Statistics 


Pool allocation calls 430 
Pool allocation failures £0 
Pool deallocation calls : 0 
Page allocation calls 2745 
Page deallocation calls : 6 


Cache VA Regions and Limits 


Cache VA region from FFFFFFFD80000000 to FFFFFFFF80000000 ( 1048576 pages) 
permanent area : FFFFFFFD80000000 to FFFFFFFDBE800000 ( 128000 pages) 
pool : FFFFFFFD80000000 to FFFFFFFD83200000 ( 6400 pages) 
data : FFFFFFFD83200000 to FFFFFFFDBE800000 ( 121600 pages) 
dynamic area : FFFFFFFDBE800000 to FFFFFFFF7F780000 ( 919488 pages) 
pool : FFFFFFFDBE800000 to FFFFFFFDD4F2C000 ( 45974 pages) 
data : FFFFFFFDD4F2C000 to FFFFFFFF7F780000 ( 873514 pages) 
extent hash table: FFFFFFFF7F780000 to FFFFFFFF7FF80000 ( 1024 pages) 
file hash table : FFFFFFFF7FF80000 to FFFFFFFF80000000 ( 64 pages) 
file hash table : FFFFFFFF7FF80000 to FFFFFFFF80000000 ( 64 pages) 
ghdPermanentPoolFreePages : FFFFFFFF80D305B8 
qhdPermanentDataFreePages : FFFFFFFF80D305C8 
Non-Paged Pool allocated : 45248 (44.1 KB) 
Non-Paged Pool number of - FKBs : 403 
Non-Paged Pool number of - DBMs : 3 
Non-Paged Pool number of - CTXs : 10 


Current Maximum Cache Size 
Boottime Maximum Cache Size 


Permanent Data Pages: Allocated : 


In use 


Pool Pages: Allocated : 


In use 


: 8589934592 (8.0 GB) 
: -l 


121600 
2739 
6400 

128 
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SDA Extended File Cache Extension (XFC) 
SHOW MEMORY 


Dynamic Pages: Max Allowed : 919488 
Allocated : 0 
In use : 0 
Min Allowed : 20971 
Data Pages: Allowed : 873514 
In use : 0 
Pool Pages: Allowed : 45974 
In use : 0 
PFN List H 0 
Non PFN List : 0 
Total Cache Memory (bytes) : 1048621248 (1000.0 MB) 


Private PFN List Stats 


Dynamic Area PFN List : FFFFFFFF818EB340 

Free physical pages on list : 0 

Pages attributed to this list : 0 

Pages being requested for return: 0 

List priority : 0 

Callback routine : 80DF8A40 

Free PFN queue head : FFFFFFFF818EB350 
First free page : 0000000000000000 
Last free page : 0000000000000000 


MMG Callback Counters 


MMG callback active : 0 
MMG callback count : 0 
MMG callback requeues : 0 
MMG callback requeue again 0 
Expand attempts callback active : 0 
Pages reclaimed : 0 
Trim reclaim attempts : 0 
LRU depose calls TrimWorkingSet : 0 
Zone Purges: Permanent : 0 
Dynamic PFNLST 0 
Dynamic No PFNLST 0 
Pool Zone Stats (S2 Space) Permanent Dynamic 
SECB: Size 112, PerPage 71 
Pages / MaxPages 12 / 6400 0 / 45974 
FreePkts / TotalPkts 64 / 852 0 / 0 
Hits 5499 0 
Not first page 0 0 
Misses (expns/fails) 12 ( 12 /0) 0 ( 0 / 
PECB: Size 176, PerPage 45 
Pages / MaxPages 85 / 6400 0 / 45974 
FreePkts / TotalPkts 6 / 3825 0 / 
Hits 3740 0 
Not first page 0 0 
Misses (expns/fails) 85 ( 85 /0) 0 ( 
CFB: Size 544, PerPage 14 
Pages / MaxPages 29 / 6400 0 / 45974 
FreePkts / TotalPkts 3 / 406 0 / 
Hits 488 0 
Not first page 0 0 
Misses (expns/fails) 29 ( 29 /0) 0 ( 
CVB: Size 608, PerPage 13 
Pages / MaxPages 2 / 6400 0 / 45974 
FreePkts / TotalPkts 12 / 26 0 / 
Hits 12 0 
Not first page 0 0 
Misses (expns/fails) 2 ( 2 /0) 0 ( 
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IOSIZE: Size 3120, PerPage 2 
Pages / MaxPages 
FreePkts / TotalPkts 
Hits 
Not first page 
Misses (expns/fails) 


SDA Extended File Cache Extension (XFC) 


SHOW MEMORY 
0 / 6400 0/ 45974 
0/ 0 0 / 0 
0 0 
0 0 
0( 0/0) 0 ( 0 / 0) 


This example shows the full output from this command. 


SDA> XFC SHOW MEMORY/BRIEF 


XFC Memory Summary 
Current Maximum Cache Size 
Boottime Maximum Cache Size 


Permanent Data Pages: Allocated : 


In use 


Pool Pages: Allocated : 


In use 


Dynamic Pages: Max Allowed 
Allocated 
In use 
Min Allowed 
Data Pages: Allowed 
In use 
Pool Pages: Allowed 
In use 
PFN List 
Non PFN List 


Total Cache Memory (bytes) 


: 8589934592 (8.0 GB) 
: -l 


121600 
2739 
6400 

128 


919488 
0 

0 
20971 
873514 
0 
45974 
0 

0 

0 


: 1048621248 (1000.0 MB) 


This example shows the brief output from this command. 
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SDA Extended File Cache Extension (XFC) 
SHOW SUMMARY 


SHOW SUMMARY 


Displays general information about the Extended File Cache. 


Format 
SHOW SUMMARY [/STATISTICS] 
Parameters 
None. 
Qualifier 
ISTATISTICS 
Additionally, displays read and write activity arranged by I/O size. 
Example 


SDA> XFC SHOW SUMMARY 


XFC Summary 

Extended File Cache V1.0 Let unk I/Os through (Apr 18 2002 15:01:16) 

Anchor Block Address: FFFFFFFF80D30210 

Build Id: 

Cache State: 0000A010 

Cache in no-cache state: False 

MaxAllowedCacheMode: eNodeFullXFC 

Minimum cache size in Pages: 0001F400 ( 128000) 

General 

Extent Hash Table Address: FFFFFFFF7F780000 

Extent Hash Table Buckets: 524287 

File Hash Table Address: FFFFFFFF7FF80000 

File Hash Table Buckets: 32767 

Count of private CTXs: 10 

Count of private FKBs: 403 

Count of private DIOBMs: 3 

LRU 

LRU Priority 0 Queue Address: FFFFFFFF80D30288 
Queue Length: 00000446 ( 1094) 

LRU Priority 1 Queue Address: FFFFFFFF80D30298 
Queue Length: QOOO0AA5 ( 2725) 

ghdContexts Address FFFFFFFF80D302B0 

ghdIRPs Address FFFFFFFF80D302C0 

Spinlock 

Cache Spinlock: 8125E780 

Last Acquiring Module: ROOTS: [XFC.TMPSRC]XFC_SYS.C;4 
Acquiring Line: 2887 
Acquiring IPL: 0 
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Cache Tracing 

Number of trace entries: 

Size of trace buffer: 

Current trace level: 

Lost trace entrys: 

Current trace sequence number: 


SHOW SUMMARY 


10000 
800000 
4 

0 
318768 


System Wide I/O Statistics since last reset 


19-APR-2002 07:10:23.43 


Time of Last System-Wide Reset: 


Total cache calls: 
Total cache calls: 
- Sum of Paging I/Os: 
- and other QIOs: 
- and NoCVB or PermNoCache QIOs: 


Total Virtual Reads: 
Total Virtual Writes: 
Total PageIOs not cached: 
Total Logical I/Os: 

Total Physical I/Os: 
Total bypass write I/Os: 


Synchronous I/O completions: 
Physical I/O completions: 
Total PID completion I/Os: 


Total num IOs on reserved files: 
Total num IOs on global sections: 
Count of stalls performed: 


System Wide Read Percentage: 
System Wide Cache Hit ratio: 


4505 
4505 
2493 
2012 

0 


4197 
112 
196 


1606 
247 
13 


97.40 
57.90 


AP AO 


System-Wide Read Statistics since last reset 


Virtual Reads: 
Sum of Read Around Count: 
and Read Through Count: 
Reads Completed: 
Read Hits: 
Read Cache Hit Percentage: 
Total Synch Completion Count: 
Read Around due to Het. Cluster: 
Read Around due to Modifiers: 
Read Around due to Size: 
Total reads past EOF: 
Total I/Os with read-ahead: 
Read Hits due to read-ahead: 
Paging I/Os: 


239 
307 
2493 


System-Wide Write Statistics since last reset 


Virtual Writes: 

Sum of Write Around Count: 

and Write Through Count: 
Write Around due to Het. Cluster: 
Writes Completed: 
Write Around due to Modifiers: 
Write Around due to Size: 
Total writes past EOF: 
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SHOW SUMMARY 


File/Volume Statistics 


Open 


Files: 


Closed Files in the Cache: 
Number of files truncated: 
Volumes in Full XFC Mode: 
Volumes in VIOC Compatible Mode: 
Volumes in No Caching Mode: 


Volumes in Perm. No Caching Mode: 


Volu 


me Queue: 


File/Volume Statistics 


FAL 
FAL 
FAL 
FAL 
FAL 


I/Os 


currentl 
chosen t 
acquired 
released 
converte 


locks 
locks 
locks 
locks 
locks 


that have sta 


y held: 

o skip: 
since boot: 
since boot: 

d: 


lled for FAL 


CACHESACCESS stalls for CFB 


ulSt 


alloOpQStalls 


Read-thro->Read-around conv. 

Writes converted to write-around 
ulLockResourceExhaustionRetries: 
ulFALLocksEverInContention: 
ulFALUpConversionRequests: 
ulFALLocksConvertedToPR: 


ulFALLocksConvertedToNL: 
FAL BLIKASTs received: 
FAL B1kASTs ignored: 


ECBs 
ECBs 


Split Right: 
Split Left: 


ECBs Split Three Ways: 
ECBs Requiring no splits: 


Volume Lock Statistics 


VCML 
VCML 
VCML 
VCML 
VCML 


Blocking ASTs 
Blocking ASTs 
Blocking ASTs 
Blocking ASTs 
Up-conversion 
Up-conversion 
Blocking ASTs 
Blocking ASTs 
Blocking ASTs 
Blocking ASTs 
Up-conversion 
Up-conversion 


received 
stalled 
started 
completed 
requests made 
grants 
received 
stalled 
started 
completed 
requests made 
grants 


Stalls on VCML up-conversion 
Restarts on VCML up-conversion 


Quiesce and Depose Statistics 


Quiesce and Depose files 
File Quiesce and Deposes 
File Quiesce and Deposes 
File Quiesce and Deposes 


Cmpltd: 
Cmpltd: 


Q&D CTX used count: 


Q&D 


CTX in use: 
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Stalled: 
Started: 


13 

1 

0 
FFFFFFFF80D30238 


ol 
Co US 


rPFOoOOWWDOOOCrF O&O 


BO 
BO 
Bo 
Nema) 


oe Of 2 OC: 0 2 oo Soa 2 


SDA Extended File Cache Extension (XFC) 


SHOW SUMMARY 
Most recent Depose time 0.0005 msec. 
Most recent Depose ECB count 0 
Maximum Depose time 0.1125 msec. 
Maximum ECBs deposed 3 
Total Depose time 0.0002 seconds 
Total ECBs deposed 6 


Pending Lock Up-conversion Statistics 


Up-conversions stalled: 0 
Up-conversions started: 0 


This example shows the output of detailed statistics and status for the cache. 
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SHOW TABLES 


Displays both the extent hash table (HHT) and the file hash table (FHT). 


Format 
SHOW TABLES [/ALL][/EXTENT][/FILE][//SUMMARY] 


Parameters 


None. 


Qualifiers 


/ALL 
Displays the contents of the extent hash table (EHT) and file hash table (FHT). 
This is the default. 


/EXTENT 
Displays only the contents of the EHT. 


/FILE 
Displays only the contents of the FHT. 


/SUMMARY 
Displays summary information about EHT and FHT. 


Description 
The SHOW TABLES command outputs information about the two hash tables 
used by XFC to locate key data structures. 


Example 


SDA> XFC SHOW TABLES/SUMMARY 
Full Map of CFB HashTable 


FHT: Contents of 32768 buckets 


0 (32366) 

1(401) 

2(1) 
Total number of CFBs: 403 
Longest chain length: 2 


Shortest chain length: 0 
Shortest chain length: 0 
Average chain length: 0.01 


Full Map of PECB HashTable 


EHT: verifying 524288 buckets 
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SHOW TABLES 
0(520501) 
1(3755) 
2(32) 
Total number of PECBs: 3819 
Longest chain length: 2 
Shortest chain length: 0 
Average chain length: 0.01 


This example shows summary output about each of the hash tables. 
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SHOW TRACE 


Displays all or selected portions of the XFC trace buffer, starting with the most 
recent entry and moving backward in time. 


Format 
SHOW TRACE. [/ALL]/CONTAINING=value |/CPU=cpu-num 
|/LINENUMBER=linenumber 
|/MATCH [=[AND1OR]] |/Px=value 
Parameters 
None. 
Qualifiers 
/JALL 


Displays the entire trace buffer. This is the default. 


/CONTAINING=value 
Displays only records where any of the traced parameters is equal to value. 


/CPU=cpu-num 
Displays only records from threads executing on CPU cpu-num. 


/LINENUMBER=!/inenumber 
Displays only records from tracepoints at line linenumber in the relevant source 
files. 


/MATCH [=AND1 OR] 
Alters the sense of the match condition when more than one of the filter qualifiers 
/CPU, /LINENUMBER, /FILENAME, /Px, or /CONTAINING are specified. 


/Px=value 
Displays only records where one of the traced parameters P1, P2, P3, or P4 is 
equal to value. 

Description 


The SHOW TRACE command outputs the contents of each entry in the XFC trace 
buffer. Currently, detailed XFC tracing is enabled only for debug versions of XFC. 
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SDA> XFC SHOW TRACE 


XFC Trace Buffer 


Sequence 
319011 
319010 
319009 
319008 
319007 
319006 
319005 
319004 
319003 
319002 


Label 

09:11:16.70 SYS $IOPOST pl, p2, p3 
09:11:16.70 SYS S$IOPOST 
09:11:16.69 Sys LOGIO 

09:11:16.69 Sys Logical_I01 
09:11:16.69 Sys Logical_Io0 

0 1:16.69 Mem FreeContext 

0 1:16.69 Sys eiopCloseComplete 
09:11:16.69 Common Restart CFBW 
09:11:16.69 Sys eiopCloFlushed 
09:11:16.69 Sys eiopCloseInit 


This example shows the 


Line 
8811 
8803 
5305 
4989 
4981 
1829 
8276 
332 

7700 
7659 
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SHOW TRACE 


WWWWWWWwWwooA 


WHO DMDDONNNA BH 


Pl P2 P3 Pa 


000000000001000C 0000000000000200 00000010B9BFF800 000002000087A72D 
FFFFFFFF81987940 0000000000000002 000000000000600B FFFFFFFF8150F200 
0000000000000000 0000000000088000 0000000000000009 0000000000000010 
0000000000088000 0000000000000000 FFFFFFFF8150F200 FFFFFFFF81905100 
FFFFFFFF81987940 FFFFFFFFB9BFF800 0000000000000200 000000000087A72D 
FFFFFFFF81905910 FFFFFFFF81905F80 0000000000000000 0000000000000000 
FFFFFFFF81905910 FFFFFFFD831853A0 0000000000000000 0000000000000000 
FFFFFFFD831853A0 0000000000000000 0000000000000003 0000000000000000 
FFFFFFFF81905910 FFFFFFFD831853A0 0000000000000000 0000000000000000 
FFFFFFFF81905910 FFFFFFFD831853A0 0000000000000000 0000000000000000 


output of XFC trace information. 
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SHOW VOLUME 


Format 


Parameter 


Qualifiers 


Description 


Examples 


Displays the contents of a cache volume block (CVB). 


SHOW VOLUME [address]/BRIEF |/FULL| /NAME=D/SkK$volume_label| 


/STATISTICS 


address 
The address of a CVB. If no address is supplied, then all volumes are displayed. 


/BRIEF 
Displays summary information for each volume. 


/FULL 
Displays a complete list of information about each volume. This is the default. 


/NAME=D!SK$volume_label 
Displays information for the volume with the specified name. 


ISTATISTICS 
Displays the read and write I/O activity for this volume. The /STATISTICS 
qualifier is incompatible with the /BRIEF qualifier. 


The SHOW VOLUME command shows state information and statistics about all 
volumes mounted on the system. 


1. SDA> XFC SHOW VOLUME/BRIEF 


Summary of XFC Cached Volumes (CVBs) 


Volume Name 


DISKSSNKRNET 
DISKSFRROOGSYS 
DISK$V73_DENBO2 
DISK$DENBO2_V73 
DISKSVEALSYS 
DISK$SCRATCH2 
DISKS$SCRATCH1 
DISK$BRAMHA_SCR 
DISKSCOMMON 
DISK$X907_BRAMHA 
DISKSOLDSYS 
DISK$RAM_FRROOG 
DISK$RMSTA2_USER 
DISK$FRROOG_RUBY 


Volumes found: 14 


CVB Open Closed Total Read Read Write - Response (Milliseconds)... 
Files Files I/Os Hits Count Count Hits disk Average 

FFFFFFFD8311C080 0 0 0 0 0 0 

FFFFFFFD831FFD00 0 0 0 0 0 0 

FFFFFFFD831FFAA0 0 0 0 0 0 0 

FFFFFFFD831FF840 0 1 a 0 a 0 0.0000 14.2451 14.2451 

FFFFFFFD831FF5E0 0 0 0 0 0 0 

FFFFFFFD831FF380 0 0 0 0 0 0 

FFFFFFFD831FF120 0 0 0 0 0 0 

FFFFFFFD831FEECO 0 0 0 0 0 0 

FFFFFFFD831FEC60 0 0 0 0 0 0 

FFFFFFFD831FEA00 0 0 0 0 0 0 

FFFFFFFD831FE7A0 0 1 1 0 1 0 0.0000 7.8946 7.8946 

FFFFFFFD831FE540 0 0 0 0 0 0 

FFFFFFFD831FE2E0 3 5 115 89 112 3 0.0370 20.7218 4.7135 

FFFFFFFD831FE080 236 157 4195 2408 4085 110 0.0789 4.8671 2.1186 


VM-1058A-Al 


This example shows the output derived from invoking the /BRIEF qualifer. 
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2. SDA> XFC SHOW VOLUME FFFFFFFD831FE080 
Cache Volume Block (CVB) 


Statistics Valid From: 


Name: 
CVB Address: 
Flink: 
Blink: 
Volume (VCB): 
Unit (UCB): 
Files Queue: 

Flink: 

Blink: 
Cached Open Files: 
Cached Closed Files: 
Files Ever Opened: 
Files Ever Deposed: 
Pages Allocated: 
Total QIOs: 
Read Hit Count: 
Virtual Read Count: 
Virtual Write Count: 
Read Percentage: 
Hit Rate: 


19-APR-2002 07:10:23.54 


DISKS$FRROOG RUBY 
FFFFFFFD831FE080 
FFFFFFFF80D30238 
FFFFFFFD831FE300 
FFFFFFFF81905100 
FFFFFFFF8150F200 
FFFFFFFD831FE0C0 
FFFFFFFD83111800 
FFFFFFFD831FC0A0 
236 


57 % 


Average Overall I/O response time to this Volume 


in milliseconds: 


2.1186 


Average Cache Hit I/O response time to this Volume 


in milliseconds: 


0.0789 


Average Disk I/O response time to this Volume 


in milliseconds: 


Accuracy of I/O resp time: 


Readahead Count: 
Volume Caching Mode: 
Mounted /NOCACHE: 
Quiescing: 

No Cache from Logio: 
Flush Pending: 

VCML Blk CTX Stall: 
Dismount Stall: 
Flush in Progress: 
Dismount Pending: 
Tge In Use: 


VIL blocking AST CTX: 
VCML blocking AST CTX: 


Dismount Stall CTX: 
LogI0O Stall CTX: 
Up conversion CTX: 
VIL lock id: 
VIL LogIO lock id: 
VCML lock id: 
VCML LogIO lock id: 
Logical I0 safety: 
LogIOMutex: 
Last LogIO time: 
Active I/O count: 
Stalled Ops Queue: 
Flink: 
Blink: 


Volumes found: 1 


4.8671 
83 % 
233 
evemVI0CCompatible 
False VCML Allows Caching: 
False Quiesce in Progress: 
False VIL Blk AST Stall: 
False VCML Blk AST Stall: 
False VIL Blk CTX Stall: 
False Logio Stall: 
False Cluster Trans Stall: 
False VIL Up Needed: 
False VCML Up Needed: 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0100007A 
00000000 
010000FF 
00000000 
elogioNotSafe 
00000000818EB610 
00000000 
0 
FFFFFFFD831FE0B0 
FFFFFFFD831FE0B0 
FFFFFFFD831FE0B0 


True 

False 
False 
False 
False 
False 
False 
False 
False 


This example shows the output for a specific cache volume block (CVB). 
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SDA Callable Routines Extension 


This chapter describes how to write, debug, and invoke an SDA Extension. This 
chapter also describes the routines available to an SDA Extension. 


10.1 Introduction 


When analysis of a dump file or a running system requires intimate knowledge 
of data structures that are not known to the System Dump Analyzer, the 
functionality of SDA can be extended by the addition of new commands into which 
the necessary knowledge has been built. Note that in this description, whenever 
a reference is made to accessing a dump file (ANALYZE/CRASH_DUMP), this 
also includes accessing memory in the running system (ANALYZE/SYSTEM). 


For example, a user-written device driver allocates nonpaged pool and records 
additional data about the device there (logging different types of I/O, perhaps), 
and a pointer to the new structure is saved in the device-specific extension of the 
UCB. After a system crash, the only way to look at the data from SDA is to do 
the following: 


e Invoke the SDA command DEFINE to define a new symbol (for example, 
UCB$L_FOOBAR) whose value is the offset in the UCB of the pointer to the 
new structure. 


e Invoke the SDA commands "SHOW DEVICE <device>" and "FORMAT UCB" 
to obtain the address of the nonpaged pool structure. 


e Invoke the SDA command "EXAMINE <address>;<length>" to display the 
contents of the data in the new nonpaged pool structure as a series of 
hexadecimal longwords. 


e Decode manually the contents of the data structure from this hexadecimal 
dump. 


An SDA extension that knows the layout of the nonpaged pool structure, and 
where to find the pointer to it in the UCB, could output the data in a formatted 
display that alerts the user to unexpected data patterns. 


10.2 Description 


The following discussion uses an example of an SDA extension that invokes the 
MBX command to output a formatted display of the status of the mailbox devices 
in the system. The source file, MBX$SDA.C, is provided in SYS$EXAMPLES. 


An SDA extension consists of a shareable image, in this case MBX$SDA.EXE, 
either located in the directory SYS$LIBRARY or found by translating the logical 
name MBX$SDA. It contains two universal symbols: SDA$EXTEND, the entry 
point; and SDA$EXTEND_VERSION, the address of a longword that contains the 
version of the interface used (in the format of major/minor ident), which allows 
SDA to confirm it has activated a compatible extension. The image contains 

at least two modules: MBX$SDA, the user-written module that defines the 
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two symbols and provides the code and data necessary to produce the desired 
formatted output; and SDA_EXTEND_ VECTOR, which provides jackets for all 

of the callable SDA routines, and is found in SYS$LIBRARY: VMS$VOLATILE_ 
PRIVATE_INTERFACES.OLB. The user-written portion can be split into multiple 
modules. 


Whenever SDA receives an unrecognized command, like "SDA> MBX", it attempts 
to activate the shareable image MBX$SDA at the SDA$EXTEND entry point. 

If you choose a command name that matches the abbreviation of an existing 
command, SDA can be forced to activate the extension using the "DO" command. 
For example, if you had an SDA extension called VAL$SDA, you could not 
activate it with a command like "SDA> VAL" as SDA would interpret that as 

an abbreviation of its VALIDATE command. But VAL$SDA can be activated by 
issuing "SDA> DO VAL". 


With or without the "DO" prefix, the rest of the command line is passed to the 
extension; it is up to the extension to parse it. The example extension MBX$SDA 
includes support for commands of the form "SDA> MBX SUMMARY" and 
"SDA> MBX <address>" to demonstrate this. If the extension is invoked with no 
arguments, it should do no more than display a simple announcement message, 
or prompt for input. This assists in the debugging of the extension, as described 
in Section 10.3. 


Section 10.2.1 describes how to compile, link, and invoke an SDA extension, and 
describes what an SDA extension should contain. 


10.2.1 Compiling and Linking an SDA Extension 


The user-written module is only supported when written in HP C (minimum 
Version 5.2), following the pattern of the example extension, MBX$SDA.C. It 
should be compiled and linked using commands of the following form: 


$cc mbx$sda + sys$library:sys$lib c /library 
Slink /share - _ 
mbx$sda.obj, - 
sys$library:vms$volatile private interfaces /library, - 
sys$input /option ~ ~ 
symbol _ vector = (sda$extend=procedure) 
symbol vector = (sda$extend_version=data) 


Note 


1. You can include the qualifier /INSTRUCTION=NOFLOAT on the 
compile command line if floating-point instructions are not needed. 


2. The + ALPHASLIBRARY:SYSS$LIB C /LIBRARY is not needed on the 
compile command line if the logical name DECC$TEXT_LIBRARY is 
defined and translates to ALPHA$LIBRARY:SYS$LIB_C.TLB. 


3. If the user-written extension needs to signal SDA condition 
codes, or output their text with $PUTMSG, you should 

add the qualifier /INCLUDE=SDAMSG to the parameter 
ALPHASLIBRARY:VMS$VOLATILE PRIVATE INTERFACES / LIBRARY. 


10-2 SDA Callable Routines Extension 


SDA Callable Routines Extension 
10.2 Description 


10.2.2 Invoking an SDA Extension 


You can invoke the SDA extension as follows: 


Sdefine mbx$sda sys$disk:[ ]mbx$sda 
Sanalyze /system 

SDA>mbx summary 

SDA>mbx <address> 


10.2.3 Contents of an SDA Extension 
At a minimum, the user-written module must contain: 
e #include statements for DESCRIP.H and SDA_ROUTINES.H 
e The global variable SDASEXTEND_VERSION, initialized as follows: 
int sda$extend_ version = SDA_FLAGSSK VERSION; 
e The routine SDA$EXTEND (prototype follows) 
Optionally, the user-written module may also contain the statement: 
#define NEW STARLET 


You should use this option because it provides type checking of function 
arguments and gives consistency in casing and naming conventions. 


The entry point in the user-written module, SDA$EXTEND, is called as a routine 
with three arguments and no return value. The declaration is as follows: 
void sdaSextend ( 
int *transfer table, 
struct dscS$descriptor s *cmd line, 
SDA_FLAGS sda flags) ~ ~ 


The arguments in this code example have the following meanings: 
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Line of Code 


Meaning 


transfer_table 


cmd_line 


sda_flags 


Address of the vector table in the base image. The user-written 
routine SDA$EXTEND must copy this to SDASEXTEND_ 
VECTOR_TABLE_ADDR before any SDA routines can be called. 


Address of the descriptor of the command line as entered by 
the user, less the name of the extension. So, if you enter "SDA> 
MBX" or "SDA> DO MBX", the command line is a zero length 
string. If you enter the command "SDA> MBX 80102030", 

the command line is " 80102030" (the separating space is not 


stripped). 


Definition for the following four bits in this structure: 


Bit 


Meaning 


sda_flags.sda_flags$v_override 


sda_flags.sda_flags$v_current 


sda_flags.sda_flags$v_target 


sda_flags.sda_flags$v_process 


None of the above bits set 


Other bits 


Indicates SDA has 
been activated with 
the ANALYZE/CRASH _ 
DUMP/OVERRIDE 
command 


Indicates SDA has 

been activated with the 
ANALYZE/SYSTEM 
command or was invoked 
from the kept debugger 
during an SCD session 


Indicates that SDA was 
invoked from the kept 
debugger during an SCD 
or SDD session or when 
analyzing a process dump 


Indicates SDA was activated 
with the ANALYZE/CRASH_ 
DUMP command to analyze 
a process dump 


Indicates SDA was activated 
with the ANALYZE/CRASH_ 
DUMP command to analyze 
a system dump 


Reserved to HP 


The first executable statement of the routine must be to copy TRANSFER_TABLE 
to SDA$VECTOR_TABLE (which is declared in SDA_ROUTINES.H): 


sda$vector_ table = transfer_table; 


If this is not done, you cannot call any of the routines described below. Any 


attempts to call the routines receive a status return of SDA$_VECNOTINIT. (For 
routines defined not to return a status, this value can be found only by examining 
RO.) 


The next statement should be one to establish a condition handler, as it is often 
difficult to track down errors in extensions such as access violations because the 
extension is activated dynamically with LIB$FIND_IMAGE_SYMBOL. A default 
condition handler, SDA$¢COND_HANDLER, is provided that outputs the following 
information in the event of an error: 


e The error condition 
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The VMS version 
A list of activated images, with start and end virtual addresses 
The signal array and register dump 


The current call frame chain 


You can establish this condition handler as follows: 


libSestablish (sda$cond_handler) ; 


Note 


The error condition, signal array, and register dump are output directly to 
SYS$OUTPUT and/or SYS$ERROR, and are not affected by the use of the 
SDA commands SET OUTPUT and SET LOG. 


Thus, a minimal extension would be: 


#define NEW STARLET 1 
#include <descrip.h> 
#include <sda_routines.h> 


int sda$extend_ version = SDA_FLAGSS$K_VERSION; 


void sda$extend (int *transfer_table, 
struct dsc$descriptor s *cmd_ line, 
SDA_FLAGS sda_flags) 


sdaSvector table = transfer table; 
lib$establish (sda$cond_handler) ; 


sdaSprint ("hello, world"); 
return; 


} 


10.3 Debugging an Extension 


In addition to the "after-the-fact" information provided by the condition handler, 
you can debug SDA extensions using the OpenVMS Debugger. A second copy of 
the SDA image, SDA_DEBUG.EXE, is provided in SYS$SYSTEM. By defining 
the logical name SDA to reference this image, you can debug SDA extensions as 
follows: 


Compile your extension /DEBUG/NOOPT and link it /DEBUG or /DSF. 
Define logical names for SDA and the extension, and invoke SDA. 


Type SET BREAK START_EXTENSION at the initial DBG> prompt, and 
then type GO. 


Invoke the extension at the SDA> prompt. 


When Debug prompts again, use Debug commands to set breakpoints, and so 
on, in the extension and then type GO. 


Invoke the extension, providing the necessary arguments. 
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An example of the preceding steps is as follows: 


$ cc /debug /noopt mbx$sda + alpha$library:sys$lib c /library 

$ link /debug /share - ~ 
mbx$sda.obj, - 
alpha$library:vms$volatile private interfaces /library, - 
sys$input /option ~ ~ 

symbol _ vector = (sda$extend=procedure) 

symbol vector = (sda$extend_version=data) 

$! 

$ define mbxS$sda sysS$disk:[ ]mbx$sda 

$ define sda sda_debug 

$ analyze /system 


DBG> set break start extension 

DBG> go ~ 

SDA> mbx 

break at routine START\START EXTENSION 

DBG> set image mbx$sda 

DBG> set language c 

DBG> set break /exception 

DBG> go 

MBX commands: ‘MBX SUMMARY’ and ‘MBX <address>’ 
SDA> mbx summary 


SDA> mbx <address> 


%DEBUG-I-DYNMODSET, setting module MBXSSDA 
SSYSTEM-E-INVARG, invalid argument 


DBG> 


10.4 Callable Routines Overview 


The user-written routine may call SDA routines to accomplish any of the 
following tasks: 


Read the contents of memory locations in the dump. 


Translate symbol names to values and vice-versa, define new symbols, and 
read symbol table files. 


Map an address to the activated image or executive image that contains that 
address. 


Output text to the terminal, with page breaks, page headings, and so on (and 
which is output to a file if the SDA commands SET OUTPUT or SET LOG 
have been used). 


Allocate and deallocate dynamic memory. 
Validate queues/lists. 
Format data structures. 


Issue any SDA command. 
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The full list of available routines is as follows: 


SDA$ADD_SYMBOL 
SDA$ALLOCATE 
SDA$DBG_IMAGE_INFO 
SDA$DEALLOCATE 
SDA$DISPLAY_HELP 
SDA$SENSURE 

SDA$FAO 

SDA$FORMAT 
SDA$FORMAT_ HEADING 
SDA$GET_ADDRESS 
SDA$GET_BLOCK_NAME 
SDA$GET_BUGCHECK_MSG 
SDA$GET_CURRENT_CPU 
SDA$GET_CURRENT_PCB 
SDA$GET_DEVICE_NAME 
SDA$GET_HEADER 
SDA$GET_HW_NAME 
SDA$GET_IMAGE_ OFFSET 
SDA$GET_INPUT 


SDA$GET_LINE_COUNT 
SDA$GETMEM 
SDA$INSTRUCTION_DECODE 
SDA$NEWPAGE 
SDA$PARSE_COMMAND 
SDA$PRINT 
SDA$READ_SYMFILE 
SDA$REQMEM 
SDA$SET_ADDRESS 
SDA$SET_CPU 
SDA$SET_HEADING_ROUTINE 
SDA$SET_LINE_COUNT 
SDA$SET_PROCESS 
SDA$SKIP_LINES 
SDA$SYMBOL_VALUE 
SDA$SYMBOLIZE 
SDA$TRYMEM 

SDA$TYPE 
SDA$VALIDATE_QUEUE 


The details of all these routines follow. But there are some points to be aware of 


in using them: 


e There are three different routines available to read the contents of 
memory locations in the dump: SDA$TRYMEM, SDA$GETMEM, and 
SDA$REQMEM. They are used as follows: 


SDA$TRYMEM is called from both SDASGETMEM and SDA$REQMEM as 
the lower-level routine that actually does the work. SDA$TRYMEM returns 
success/failure status in RO, but does not signal any errors. Use it directly 
when you expect that the location being read may be inaccessible. The caller 
of SDA$TRYMEM will handle this situation by checking the status returned 


by SDA$TRYMEM. 


SDA$GETMEM signals a warning when any error status is returned from 
SDA$TRYMEM. Signaling a warning will print out a warning message, but 
does not abort the SDA command in progress. You should use this routine 
when you expect the location to be read to be accessible. This routine does 


not prevent the command currently being executed from continuing. The 
caller of SDA$GETMEM must allow for this by checking the status returned 
by SDA$GETMEM. 


SDA$REQMEM signals an error when any error status is returned from 
SDA$TRYMEM. Signaling an error will print out an error message, abort the 
SDA command in progress and return to the "SDA>" prompt. You should use 
this routine when you expect the location to be read to be accessible. This 
routine will prevent the command currently being executed from continuing. 
The caller of SDA$REQMEM will not resume if an error occurs. 
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e You should use only the routines provided to output text. Do not use 
printf() or any other standard routine. If you do, the SDA commands SET 
OUTPUT and SET LOG will not produce the expected results. Do not 
include control characters in output (except tab); in particular, avoid <CR>, 
<LF>,<FF>, and the FAO directives that create them. Use the FAO directive 
!AF when contents of memory returned by SDA$TRYMEM, and so on, are 
being displayed directly, because embedded control characters will cause 
undesirable results. For example, displaying process names or resource 
names that contain particular control characters or escape sequences can lock 
up the terminal. 


e You should use only the routines provided to allocate and deallocate dynamic 
memory. Do not use malloc() and free(). Where possible, allocate dynamic 
memory once, the first time the extension is activated, and deallocate it only 
if it needs to be replaced by a larger allocation. Because SDA commands can 
be interrupted by invoking another command at the "Press return for more" 
prompt, it is very easy to cause memory leaks. 


e Some routines expect 32-bit pointers, and others expect 64-bit pointers. At 
first this not may appear to be logical, but in fact it is. All code and data used 
by SDA and any extensions must be in PO or P1 space, as SDA does not need 
to (and does not) use P2 space for local data storage. However, addresses in 
the system dump (or running system, in the case of ANALYZE/SYSTEM) are 
64-bit addresses, and SDA must provide access to all locations in the dump. 


So, for example, the first two arguments to the routine SDA$TRYMEM are: 


VOID PQ start /* 64-bit pointer */ 
void *dest /* 32-bit pointer */ 


They specify the address of interest in the dump and the address in local storage 
to which the dump contents are to be copied. 


10.5 Routines 


The following section describes the SDA extension callable routines. 
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SDA$ADD_SYMBOL 


Adds a symbol to SDA’s local symbol table. 


Format 
void sda$add_symbol (char *symbol_name, uint64 symbol_value); 
Arguments 
symbol_name 
OpenVMS usage _ char_string 
type character string 
access read only 
mechanism by reference 
Address of symbol name string (zero-terminated). 
symbol_value 
OpenVMS usage quadword_unsigned 
type quadword (unsigned) 
access read only 
mechanism by value 
The symbol value. 
Description 


SDA maintains a list of symbols and the corresponding values. SDA$¢ADD_ 
SYMBOL is used to insert additional symbols into this list, so that they can be 
used in expressions and during symbolization. 


Condition Values Returned 
None 


Example 


sda$add_symbol ("MBX", 0xFFFFFFFF80102030); 
This call defines the symbol MBX to the hexadecimal value FFFFFFFF80102030. 


SDA Callable Routines Extension 10-9 


SDA Callable Routines Extension 
SDA$ALLOCATE 


SDA$ALLOCATE 


Allocates dynamic memory. 


Format 

void sda$allocate (uint32 size, void **ptr_block); 
Arguments 

size 

OpenVMS usage longword_unsigned 

type longword (unsigned) 

access read only 

mechanism by value 

Size of block to allocate (in bytes). 

ptr_block 

OpenVMS usage _ address 

type longword (unsigned) 

access write only 

mechanism by reference 

Address of longword to receive address of block. 
Description 


The requested memory is allocated and the address returned. Note that this is 
the only supported mechanism for allocation of dynamic memory. 


Related Routine 
SDA$DEALLOCATE 


Condition Values Returned 


None 


If no memory is available, the error is signaled and the SDA session aborted. 
Example 
PCB *local pcb; 


sda$allocate (PCB$C_LENGTH, (void *)&local_pcb); 


This call allocates a block of heap storage for a copy of a PCB, and stores its 
address in the pointer LOCAL_PCB. 
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SDA$DBG_IMAGE_INFO 


Displays a list of activated images together with their virtual address ranges for 
debugging purposes. 


Format 
void sda$dbg_image_info (); 


Arguments 


None. 


Description 


A list of the images currently activated, with their start and end addresses, is 
displayed. This is provided as a debugging aid for SDA extensions. 


Condition Values Returned 


None 


Example 


sda$dbg_image info (); 
SDA outputs the list of images in the following format: 


Current VMS Version: "X6DX-FT1" 
Process Activated Images: 


Start VA End VA Image Name 
00010000 000301FF SDA 

00032000 00177FFF SDASSHARE 
7B508000 7B58BFFF DECCSSHR 
7B2D8000 7B399FFF DPMLSSHR 
7B288000 7B2C9FFF CMASTIS SHR 
73698000 7B6D9FFF LBRSHR 
0021A000 0025A3FF SCRSHR 
00178000 002187FF SMGSHR 
7B1E8000 7B239FFF LIBRTL 
7B248000 7B279FFF LIBOTS 
80C140D0 80C23120 SYSSBASE IMAGE 
80C036B8 80C05288 SYSSPUBLIC VECTORS 
002C6000 002D31FF PRGDEVMSG — 
002D4000 OQ02DA9FF SHRIMGMSG 
002DC000 O002DFFFF DECCSMSG 
00380000 003E03FF MBXSSDA 
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SDA$DEALLOCATE 


Format 


Arguments 


Description 


Deallocates and frees dynamic memory. 


void sda$deallocate (void *ptr_block, uint32 size); 


ptr_block 

OpenVMS usage _ address 

type longword (unsigned) 
access read only 
mechanism by value 


Starting address of block to be freed. 


size 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Size of block to deallocate (in bytes). 


The specified memory is deallocated. Note that this is the only supported 
mechanism for deallocation of dynamic memory. 


Related Routine 
SDA$ALLOCATE 


Condition Values Returned 


Example 


None 


If an error occurs, it is signaled and the SDA session aborted. 


PCB *local pcb; 
sda$deallocate ((void *)local_pcb, PCB$C_LENGTH; 


This call deallocates the block of length PCB$C_LENGTH whose address is stored 
in the pointer LOCAL_PCB. 
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SDA$DISPLAY_HELP 


Format 


Arguments 


Description 


Displays online help. 


void sda$display_help (char *library_desc, char *topic_desc); 


library 

OpenVMS usage _ char_string 
type character string 
access read only 
mechanism by reference 


Address of library filespec. Specify as zero-terminated ASCII string. 


topic 

OpenVMS usage _ char_string 
type character string 
access read only 
mechanism by reference 


Address of topic name. Specify as zero-terminated ASCII string. 


Help from the specified library is displayed on the given topic. 


Condition Values Returned 


Example 


None 


sdaSdisplay help ("SYSS$HELP:SDA", "HELP"); 


This call produces the following output at the terminal: 
HELP 


The System Dump Analyzer (SDA) allows you to inspect the contents 
of memory as saved in the dump taken at crash time or as exists 
in a running system. You can use SDA interactively or in batch 
mode. You can send the output from SDA to a listing file. You can 
use SDA to perform the following operations: 
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SDA$DISPLAY_HELP 


Assign a value to a symbol 

Examine memory of any process 

Format instructions and blocks of data 
Display device data structures 

Display memory management data structures 
Display a summary of all processes on the system 
Display the SDA symbol table 

Copy the system dump file 

Send output to a file or device 

Read global symbols from any object module 
Send output to a file or device 

Read global symbols from any object module 
Search memory for a given value 


For help on performing these functions, use the HELP command and 


specify a topic. 


Format 


HELP [topic-name] 


Additional information available: 


Parameter 


HELP Subtopic? 
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SDASENSURE 


Ensures sufficient space on the current output page. 


Format 
void sda$ensure (uint32 lines); 
Argument 
lines 
OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 
Number of lines to fit on a page. 
Description 


This routine checks and makes sure that the number of lines specified fit on the 
current page; otherwise, it issues a page break. 


Condition Values Returned 
None 


Example 


sdaSensure (5); 


This call ensures that there are five lines left on the current page, and it outputs 
a page break if there are not. 
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SDA$FAO 


Format 


Arguments 


Description 


Formats data into a buffer. 


char * sda$fao (char * ctrstr, char * buffer, int buflen optional_params); 


—— 


ctrsir 

OpenVMS usage _ char_string 

type character-coded text string 
access read only 

mechanism by reference 


Addess of a zero-terminated FAO control string. 


buffer 

OpenVMS usage _ char_string 
type character string 
access write only 
mechanism by reference 


Address of a string buffer into which to store the formatted string. 


buflen 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Maximum size of the string buffer. 


prmlist 

OpenVMS usage varying_arg 

type quadword (signed or unsigned) 
access read only 

mechanism by value 


Optional FAO parameters. All arguments after buflen are copied into a quadword 
parameter list, as used by $FAOL_64. 


Formats data into a buffer as a zero-terminated string. 


Condition Values Returned 


Address of terminating zero SDA$FAO returns the address of the terminating 
zero in the output buffer. This allows successive 
calls to SDA$FAO to append strings. 
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char faobuf [16]; 
char *faoptr; 
faoptr = sdaSfao ( "!XL", 
faobuf, sizeof (faobuf), 
OxfffffffF) ; 
sda$fao ( ".!XL", 
faoptr, sizeof (faobuf) - strlen (faobuf), 
0x80102030); 


This example shows the use of SDA$FAO to append a formatted string to another 
formatted string. 
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SDA$FORMAT 


Format 


Arguments 


Description 


Displays the formatted contents of a data structure. 


void sda$format (VOID_PQ struct_addr, __optional_params); 


Dees 


struct_addr 
OpenVMS usage _ address 


type quadword (unsigned) 
access read only 
mechanism by value 


The address in the system dump of the data structure to be formatted. 


options 

OpenVMS usage mask_longword 
type longword (unsigned) 
access read only 
mechanism by value 


The following provides more information on options: 


Option Meaning 


None Uses structure type from the xxx$B_ 
TYPE and/or xxx$B_ SUBTYPE field of 
the structure. This is the default. 

SDA_OPT$M_FORMAT_TYPE Uses the structure type given in struct_ 
prefix. 

SDA_OPT$M_FORMAT_PHYSICAL Indicates that struct_addr is a physical 
address instead of a virtual address. 


struct_prefix 
OpenVMS usage _ char_string 


type character string 
access read only 
mechanism by reference 


Address of structure name string (zero-terminated). 


This routine displays the formatted content of a data structure that begins at 
the address specified. If no symbol prefix is passed, then SDA tries to find the 
symbols associated with the block type specified in the block-type byte of the data 
structure. 
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Condition Values Returned 


Example 


None 


PCB *local_pcb; 
PHD *local_phd; 


sda$format (local_pcb); 
sda$format (local_phd, SDA_OPT$M_FORMAT TYPE, "PHD"); 


The first call formats the structure whose system address is held in the variable 
LOCAL_PCB, determining the type from the type and/or subtype byte of the 
structure. The second call formats the structure whose system address is held in 
the variable LOCAL_PHD, using PHD symbols. 
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SDA$FORMAT_HEADING 


Formats a new page heading. 


Format 

void sda$format_heading (char *ctrstr, __ optional_params); 
Arguments 

ctrsir 

OpenVMS usage _ char_string 

type character-coded text string 

access read only 

mechanism by reference 

Address of control string (zero-terminated ASCII string). 

prmlist 

OpenVMS usage varying_arg 

type quadword (signed or unsigned) 

access read only 

mechanism by value 

FAO parameters that are optional. All arguments after the control string are 

copied into a quadword parameter list as used by $FAOL_64. 
Description 


This routine prepares and saves the page heading to be used whenever 
SDA$NEW_PAGE is called. Nothing is output either until SDASNEW_PAGE 
is next called, or a page break is necessary because the current page is full. 


Condition Values Returned 


None 


If the $FAOL_64 call issued by SDA$FORMAT_HEADING fails, the control string 
is used as the page heading. 


Example 
char hw_name[64]; 


sdaSget hw name (hw name, sizeof(hw name)); 
sda$format heading ( ~ 
"SDA Extension Commands, system type !AZ", 
&hw name) ; 
sda$new page (); 


This example produces the following heading: 


SDA Extension Commands, system type DEC 3000 Model 400 
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SDA$GET_ADDRESS 


Gets the address value of the current memory location. 


Format 

void sda$get_address (VOID_PQ “*address); 
Argument 

address 

OpenVMS usage quadword_unsigned 

type quadword (unsigned) 

access write only 

mechanism by reference 

Location to store the current 64-bit memory address. 
Description 


Returns the current address being referenced by SDA (location "."). 


Condition Values Returned 
None 
Example 


VOID_PQ current_address; 


sda$get_address (&current_address); 


This call stores SDA’s current memory location in the long pointer CURRENT_ 
ADDRESS. 
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SDA$GET_BLOCK_NAME 


Format 


Arguments 


Description 


Returns the name of a structure, given its type and/or subtype. 


void sda$extend_get_block_name (uint32 block_type, uint32 block_subtype, 
char “buffer_ptr, uint82 buffer_len); 


block_type 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Block type in range 0 - 255 (usually extracted from xxx$b_type field). 


block_subtype 
OpenVMS usage  longword_unsigned 


type longword (unsigned) 
access read only 
mechanism by value 


Block subtype in range 0 - 255 (ignored if the given block type has no subtypes). 


buffer_ptr 

OpenVMS usage _ char_string 
type character string 
access write only 
mechanism by reference 


Address of buffer to save block name, which is returned as a zero-terminated 
string. 


buffer_len 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Length of buffer to receive block name. 


Given the block type and/or subtype of a structure, this routine returns the 
name of the structure. If the structure type is one that has no subtypes, the 
given subtype is ignored. If the structure type is one that has subtypes, and 
the subtype is given as zero, the name of the block type itself is returned. If an 
invalid type or subtype (out of range) is given, an empty string is returned. 
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Note 


The buffer should be large enough to accomodate the largest possible 
block name (25 bytes plus the termination byte). The block name is 
truncated if it is too long for the supplied buffer. 


Condition Values Returned 


None 


Example 
char buffer[32]; 


sda$get_ block name (0x6F, 0x20, 
buffer, 
sizeof (buffer) ); 
if (strlen (buffer) == 0) 
sdaSprint ("Block type: no named type/subtype"); 
else 
sdaSprint ("Block type: !AZ", buffer); 


This example produces the following output: 


Block type: VCC_CFCB 
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SDA$GET_BUGCHECK_MSG 


Format 


Arguments 


Description 


Gets the text associated with a bugcheck code. 


void sda$get_bugcheck_msg (uint32 bugcheck_code, char *buffer_ptr, uint32 
buffer_size); 


bugcheck_code 
OpenVMS usage longword_unsigned 


type longword (unsigned) 
access read only 
mechanism by value 


The bugcheck code to look up. 


buffer_ptr 

OpenVMS usage _ char_string 
type character string 
access write only 
mechanism by reference 


Address of buffer to save bugcheck message. 


buffer_len 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Length of buffer to receive message. 


Gets the string representing the bugcheck code passed as the argument. The 
bugcheck message string is passed in the buffer (represented as a pointer and 
length) as a zero-terminated ASCII string. 


Note 


The buffer should be large enough to accomodate the largest possible 
bugcheck message (128 bytes including the termination byte). The text is 
terminated if it is too long for the supplied buffer. 


Condition Values Returned 


None 
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Example 
char buffer[128]; 
sda$get_bugcheck_ msg (0x108, buffer, sizeof(buffer) ); 


sdaSprint ("Bugcheck code 108 (hex) ="); 
sda$print ("! \"!az\"", buffer); 


This example produces the following output: 


Bugcheck code 108 (hex) = 
"DOUBLDALOC, Double deallocation of swap file space" 
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SDA$GET_CURRENT_CPU 


Format 


Arguments 


Description 


Gets the CPU database address of the currently selected CPU. 


void sda$get_current_cpu (CPU **cpudb); 


cpudb 

OpenVMS usage _ address 

type longword (unsigned) 
access write only 
mechanism by reference 


Location to which the address of the CPU database is to be returned. 


This routine causes SDA to return the address of the database for the currently 
selected CPU. 


Condition Values Returned 


Example 


None 


#include <cpudef> 

CPU *current_cpu; 

sda$get_current_cpu ( &current_cpu ); 

In this example, the system address of the database for the current CPU is 
returned in variable current_cpu. 
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SDA$GET_CURRENT_PCB 


Format 


Argument 


Description 


Gets the PCB address of the "SDA current process" currently selected. 


void sda$get_current_pcb (PCB **pcbadr); 


pebadr 

OpenVMS usage quadword_unsigned 
type quadword (unsigned) 
access write only 
mechanism by reference 


Location in which to store the current PCB address. 


The PCB address of the process currently selected by SDA is returned in the 
specified location. 


Condition Values Returned 


Example 


None 


PCB *current_pcb; 
sda$get_current_pcb ( &current_pcb ); 


This call stores the system address of the PCB of the process currently being 
referenced by SDA in the pointer CURRENT_PCB. 
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SDA$GET_DEVICE_NAME 


Gets the device name, given the UCB address of the device. 


Format 

int sda$get_device_name (VOID_PQ ucb_addr, char *name_buf, int name_len); 
Arguments 

ucb_addr 

OpenVMS usage _ address 

type quadword (unsigned) 

access read only 

mechanism by value 


System address of the Unit Control Block of the device. 


name_buf 

OpenVMS usage _ char_string 
type character string 
access write only 
mechanism by reference 


Address of buffer to receive device name. 


name_len 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Length of buffer to receive device name. 


Description 


This routine creates and returns the name for the device described by the given 
UCB. The device name is returned as a zero-terminated ASCII string. 


Note 


The buffer should be large enough to accomodate the largest possible 
device name (32 bytes including the termination byte). The text is 
terminated if it is too long for the supplied buffer. 


Condition Values Returned 


SDA$_SUCCESS Successful completion 

SDA$_NOTAUCB The address given is not the address of a UCB 
SDA$ NOREAD The data is inaccessible for some reason 
Others The data is inaccessible for some reason 
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Example 


VOID_PQ address; 
char buffer[32]; 


sdaSparse command ("SHOW DEVICE DKBO:"); 

sda$symbol value ("UCB", (uint64 *)&address); 

sda$get device name ((VOID PQ)address, buffer, 32); 
sda$print ("UCB address: !XL = ""!Az:""", address, buffer); 


This example produces the following output: 


UCB address: 814A9A40 = "$31SDKB0:" 
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SDA$GET_HEADER 


Format 


Arguments 


Returns pointers to local copies of the dump file header and the error log buffer 
together with the sizes of those data structures; optionally returns pointers and 
sizes for the crash error log entry and trap data (if any). 


void sda$get_header (DMP **dmp_header, uint82 *dmp_header_size, void 
“errlog_buf, uint82 *errlog_buf_size, _ optional_params); 


— 


dmp_header 

OpenVMS usage _ address 

type longword (unsigned) 
access write only 
mechanism by reference 


Location in which to store the address of the copy of the dump file header held by 
SDA. 


dmp_header_size 
OpenVMS usage longword_unsigned 


type longword (unsigned) 
access write only 
mechanism by reference 


Location in which to store the size of the dump file header. 


errlog_buf 

OpenVMS usage _ address 

type longword (unsigned) 
access write only 
mechanism by reference 


Location in which to store the address of the copy of the error log buffer held by 
SDA. 


errlog_buf_size 
OpenVMS usage longword_unsigned 


type longword (unsigned) 
access write only 
mechanism by reference 


Location in which to store the size of the error log buffer. 


crasherl_buf 
OpenVMS usage _ address 


type longword (unsigned) 
access write only 
mechanism by reference 


Location in which to store the address of the copy of the crash error log entry 
held by SDA. 
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crasherl_buf_size 
OpenVMS usage longword_unsigned 


type longword (unsigned) 
access write only 
mechanism by reference 


Location in which to store the size of the crash error log entry. 


trapinfo_buf 
OpenVMS usage _ address 


type longword (unsigned) 
access write only 
mechanism by reference 


Location in which to store the address of the copy of the trap info, if any, held by 
SDA. 


trapinfo_buf_size 
OpenVMS usage longword_unsigned 


type longword (unsigned) 
access write only 
mechanism by reference 


Location in which to store the size of the trap data, if any. 


This routine returns the addresses and sizes of the dump header, error logs, and 
optionally the crash error log entry and trap data read by SDA when the dump 
file is opened. If this routine is called when the running system is being analyzed 
with ANALYZE/SYSTEM, then the following occurs: 


e Returns the address and size of SDA’s dump header buffer, but the header 
contains zeroes 


e Returns zeroes for the address and size of SDA’s error log buffer, the crash 
error log entry and trap data 


Trap data only exists if an access violation occurs while the dump is being 
written. Usually, the returned trapinfo_buf and trapinfo_buf_size will be zero. 


Condition Values Returned 


Example 


None 


DMP *dmp header; 

uint32 dmp header size; 
char *errlog buffer; 
uint32 errlog buffer size; 


sda$get header (&dmp header, 
“admp header size, 
(void **)&errlog buffer, 
serrlog buffer size); 


This call stores the address and size of SDA’s copy of the dump file header in 
DMP_HEADER and DMP_HEADER SIZE, and stores the address and size 
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of SDA’s copy of the error log buffers in ERRLOG_BUFFER and ERRLOG_ 
BUFFER_SIZE, respectively. 
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SDA$GET_HW_NAME 


Format 


Arguments 


Description 


Returns the full name of the hardware platform where the dump was written. 


void sda$get_hw_name (char *buffer_ptr, uint82 buffer_len); 


buffer_ptr 

OpenVMS usage _ char_string 
type character string 
access write only 
mechanism by reference 


Address of buffer to save HW name. 


buffer_len 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Length of buffer to receive HW name. 


Returns a zero-terminated ASCII string representing the platform hardware 
name and puts it in the buffer passed as the argument. 


Note 


The buffer should be large enough to accomodate the largest possible 
hardware platform name (120 bytes including the termination byte). The 
name is truncated if it is too long for the supplied buffer. 


Condition Values Returned 


Example 


None 


char hw_name[64]; 


sda$get_hw_name (hw_name, sizeof(hw_name)); 
sda$print ("Platform name: \"!AZ\"", hw_name); 
This example produces output of the form: 


Platform name: "DEC 3000 Model 400" 
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SDA$GET_IMAGE_OFFSET 


Maps a given virtual address onto an image or execlet. 


Format 
COMP_IMG_OFF sda$get_image_offset (VOID_PQ va, VOID_PQ img_info, 
VOID_PQ subimg_info, VOID_PQ offset); 
Arguments 
va 
OpenVMS usage _ address 
type quadword (unsigned) 
access read only 
mechanism by value 


Virtual address of interest. 


img_info 

OpenVMS usage _ address 

type quadword (unsigned) 
access write only 
mechanism by reference 


Pointer to return addr of LDRIMG or IMCB block. 


subimg_info 

OpenVMS usage _ address 

type quadword (unsigned) 
access write only 
mechanism by reference 


Pointer to return addr of ISD OVERLAY or KFERES. 


offset 

OpenVMS usage quadword_unsigned 
type quadword (unsigned) 
access write only 
mechanism by reference 


Pointer to address to return offset from image. 


Description 


Given a virtual address, this routine finds in which image it falls and returns 
the image information and offset. The loaded image list is traversed first to find 
this information. If it is not found, then the activated image list of the currently 
selected process is traversed. If still unsuccessful, then the resident installed 
images are checked. 
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Condition Values Returned 


SDA_CIO$V_VALID 
SDA_CIO$V_PROCESS 
SDA_CIO$V_SLICED 
SDA_CIO$V_COMPRESSED 


SDA_CIO$V_ISD_INDEX 
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Set if image offset is found 
Set if image is an activated image 
Set if the image is sliced 


Set if activated image contains compressed data 
sections 


Index into ISD_LABELS table (on Alpha, only for 
LDRIMG execlets) 


The status returned indicates the type of image if a match was found. 


SDA_CIO$V_xxx flags set: img_info type: subimg_info type: 
valid LDRIMG n/a 

valid && sliced LDRIMG ISD_OVERLAY 
valid && process IMCB n/a 

valid && process && sliced IMCB KFERES_SECTION 


On 164, SDA_CIO$V_SLICED will always be set if SDA_CIO$V_VALID is set. 
Table 10-1 and Table 10-2 describe the ISD LABELS index. 


Table 10-1 Alpha ISD_Labels Index 


SDA_CIO$K_RW 


Data (read/write) 


Index Name Meaning 

0 SDA_CIO$K_NPRO Nonpaged read only 
1 SDA_CIO$K_NPRW Nonpaged read/write 
2 SDA_CIO$K_PRO Paged read only 

3 SDA_CIO$K_PRW Paged read/write 

4 SDA_CIO$K_FIX Fixup 

5 SDA_CIO$K_INIT Initialization 

Table 10-2 164 ISD_Labels Index 

Index Name Meaning 

0 SDA_CIO$K_FIX Fixup 

1 SDA_CIO$K_INIT Initialization 

2 SDA_CIO$K_CODE Code 

3 SDA_CIO$K_SDATA Short data 

4 

5 


SDA_CIO$K_RO 


Data (read only) 
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Example 


VOID PQ va = (VOID PQ)0XFFFFFFFF80102030; 
COMP IMG OFF sda cio; 

int64 img info; — 

int64 subimg info; 

inté4 offset; 


sda cio = sda$get image offset (va, 
~  §img info, ~ 
&subimg info, 
&offset); 


For an example of code that interprets the returned COMP_IMG_OFF structure, 
see the supplied example program, SYS$EXAMPLES:MBX$SDA.C. 
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SDA$GET_INPUT 


Format 


Arguments 


Description 


Reads input commands. 


int sda$get_input (char *prompt, char *buffer, uint82 buflen); 


prompt 

OpenVMS usage _ char_string 
type character string 
access read only 
mechanism by reference 


Address of prompt string (zero-terminated ASCII string). 


buffer 

OpenVMS usage _ char_string 
type character string 
access write only 
mechanism by reference 


Address of buffer to store command. 


buflen 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Maximum length of buffer. 


The command entered is returned as a zero-terminated string. The string is not 
uppercased. If you do not enter input but simply press <return> or <ctrl/Z>, the 
routine returns a null string. 


Condition Values Returned 


Example 


SS$_NORMAL Successful completion. 
RMS$_EOF User pressed <ctrl/Z> 
int status; 


char buffer[128]; 
status = sda$get_input ( "MBX> ", buffer, sizeof (buffer) ); 


This call prompts you for input with "MBX> " and stores the response in the 
buffer. 
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SDA$GET_LINE_COUNT 


Obtains the number of lines currently printed on the current page. 


Format 

void sda$get_line_count (uint32 *line_count); 
Argument 

line_count 

OpenVMS usage longword_unsigned 

type longword (unsigned) 

access write only 

mechanism by reference 

The number of lines printed on current page. 
Description 


Returns the number of lines that have been printed so far on the current page. 


Condition Values Returned 
None 

Example 
uint32 line count; 


sda$get_line count (éline count); 


This call copies the current line count on the current page of output to the 
location LINE_COUNT. 
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SDA$GETMEM 


Format 


Arguments 


Description 


Reads dump or system memory and signals a warning if inaccessible. 


int sda$getmem (VOID_PQ start, void *dest, int length optional_params); 


a 


start 

OpenVMS usage _ address 

type quadword (unsigned) 
access read only 
mechanism by value 


Starting virtual address in dump or system. 


dest 

OpenVMS usage _ address 
type varies 
access write only 
mechanism by reference 


Return buffer address. 


length 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Length of transfer. 


physical 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


0: <start> is a virtual address. This is the default. 
1: <start> is a physical address. 


This routine transfers an area from the memory in the dump file or the running 
system to the caller’s return buffer. It performs the necessary address translation 
to locate the data in the dump file. SDA$GETMEM signals a warning and 
returns an error status if the data is inaccessible. 


Related Routines 
SDA$REQMEM and SDA$TRYMEM 
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Condition Values Returned 


SDA$_SUCCESS Successful completion 

SDA$ NOREAD The data is inaccessible for some reason. 
SDA$ NOTINPHYS The data is inaccessible for some reason. 
Others The data is inaccessible for some reason. 


If a failure status code is returned, it has already been signaled as a warning. 


Example 


int status; 
PCB *current_pcb; 
PHD *current_phd; 


status = sda$getmem ((VOID_PQ)&current_pcb->pcb$l1 phd, &current_phd, 4); 


This call returns the contents of the PCB$L_PHD field of the PCB, whose system 
address is in the pointer CURRENT_PCB, to the pointer CURRENT_PHD. 
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SDASINSTRUCTION_DECODE 


Format 


Arguments 


Translates one machine instruction into the assembler string equivalent. 


int sda$instruction_decode (void *istream_ptr, char *buffer, uint32 


buflen,__ optional_params); 

istream_ptr 

OpenVMS usage _ address 

type longword (unsigned) 
access read/write 
mechanism by reference 


Address of the pointer that points to a copy of the i-stream in a local buffer. 


buffer 

OpenVMS usage _ char_string 
type character string 
access write only 
mechanism by reference 


Address of a string buffer into which to store the output assembler string. 


buflen 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Maximum size of the string buffer. 


template_buffer 
OpenVMS usage _ char_string 


type character string 
access write only 
mechanism by reference 


(164 only.) Address of a string buffer into which to store the template string. 


template_buflen 
OpenVMS usage longword_unsigned 


type longword (unsigned) 
access read only 
mechanism by value 


(164 only.) Maximum size of the template buffer. 
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Description 


Translates a machine instruction into the assembler string equivalent. Alpha 
instructions are always 4 bytes long; 164 instructions are always in bundles that 
are 16 bytes long. The instruction stream must first be read into local memory 
and then the address of a pointer to the local copy of the instruction stream is 
passed to the routine. For every successful translated instruction, the pointer is 
automatically updated to point to the next instruction on Alpha or slot on I64. 


The output assembler string and optionally the template string is zero-terminated 


and in case of a failure a null string is returned. 


The template_buffer and template_buflen arguments only apply to 164 and are 


optional. 


Condition Values Returned 


SS$_NORMAL Successful completion. 
SS$_BADPARAM Any of the following failures: 


Output buffer too small 
Invalid register 

Invalid opcode class/format 
Could not translate instruction 


Examples 
1. Alpha 


int status; 

VOID PQ va = (VOID PQ)0XFFFFFFFF80102030; 
uint32 instruction; 

uint32 *istream = &instruction; 

char buffer[64]; 


sdaSreqmem (va, &instruction, 4); 
status = sdaSinstruction_ decode (&istream, buffer, sizeof (buffer) ); 
if ( !$VMS STATUS SUCCESS (status) ) 

sda$print ( "SDASINSTRUCTION DECODE failed, status = !XL", status); 
else 

sdaSprint ( "VA: !AZ", buffer );) 


This example on an Alpha system reads the instruction at dump location VA and 
decodes it, putting the result into BUFFER, and displays the instruction. Pointer 


ISTREAM is incremented (to the next longword). 
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2. 164 


int status; 
VOID PQ va = (VOID_PQ)0xFFFFFFFF80102030; 
uint64 instruction [2]; 
uint64 *istream = é&instruction; 
char buffer [64]; 
char template [16]; 
sda$reqmem (va, &instruction, 16); 
status = sda$instruction decode ( &istream, buffer, sizeof (buffer), 
template, sizeof (template) ); 
if ( !$VMS STATUS SUCCESS (status) ) 
sda$print ( "SDASINSTRUCTION DECODE failed, status = !XL", status); 


else 
{ 
sda$print ( " { !AzZ", template ); 
sda$print ( "VA: !Az", buffer ); 
while (((int)istream & 7) != 0)// local buffer only has to be quadword aligned 


status = sda$instruction_decode ( &istream, buffer, sizeof (buffer) ); 
if ( !$VMS STATUS SUCCESS (status) ) 


{ 
sda$print ( "SDASINSTRUCTION DECODE failed, status = !XL", status); 
break; 


} 


else 
sdaSprint ( " !AZ", buffer ); 


} 
sdaSprint ( " }" )3 
} 


This example for 164 reads the instruction bundle at dump location VA and 


decodes it, displaying each of the instructions in the bundle. Pointer ISTREAM is 


incremented (to the next octaword bundle). 
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SDA$NEW_PAGE 


Begins a new page of output. 


Format 


void sda$new_page (); 


Arguments 


None. 


Description 


This routine causes a new page to be written and outputs the page heading 
(established with SDA$FORMAT_HEADING) and the current subheading 
(established with SDA$SET_HEADING_ROUTINE). 


Condition Values Returned 
None 


Example 


sda$new_page (); 


This call outputs a page break and displays the current page heading and 
subheading (if any). 
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SDA$PARSE_COMMAND 


Parses and executes an SDA command line. 


Format 

void sda$parse_command (char *cmd_line, __optional_params); 
Arguments 

cmd_line 

OpenVMS usage _ char_string 

type character string 

access read only 

mechanism by reference 

Address of a valid SDA command line (zero-terminated). 

options 

OpenVMS usage longword_unsigned 

type longword (unsigned) 

access read only 

mechanism by value 

The options argument has the following values: 

Value Meaning 

SDA_OPT$K_PARSE DONT SAVE Indicates "do not save this command." This 

is the default. 
SDA_OPT$K_PARSE_SAVE Indicates "save this command." That is, it 
can be recalled with KPO or REPEAT. 

Description 


Not every SDA command has a callable extension interface. For example, to 
redirect SDA’s output, you would pass the command string "SET OUTPUT 
MBX.LIS" to this parse command routine. Abbreviations are allowed. 


Condition Values Returned 
None 


Example 


sda$parse command ("SHOW ADDRESS 80102030"); 


This call produces the following output: 
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FFFFFFFF.80102030 is an S0/S1 address 


Mapped by Level-3 PTE at: FFFFFFFD.FFE00408 
Mapped by Level-2 PTE at: FFFFFFFD.FF7FF800 
Mapped by Level-1 PTE at: FFFFFFFD.FF7FDFF8 
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0 


Also mapped in SPT window at: FFFFFFFF.FFDF0408 


The "SHOW ADDRESS" command is not recorded as the most recent command 
for use with the KPO key or the REPEAT command. 
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SDAS$PRINT 


Format 


Arguments 


Description 


Formats and prints a single line. 


int sda$print (char *ctrstr, __optional_params); 


3b a 


ctrstr 

OpenVMS usage _char_string 

type character-coded text string 
access read only 

mechanism by reference 


Address of a zero-terminated FAO control string. 


prmlist 

OpenVMS usage varying_arg 

type quadword (signed or unsigned) 
access read only 

mechanism by value 


Optional FAO parameters. All arguments after the control string are copied into 
a quadword parameter list, as used by $FAOL_64. 


Formats and prints a single line. This is normally output to the terminal, unless 
you used the SDA commands SET OUTPUT or SET LOG to redirect or copy the 
output to a file. 


Condition Values Returned 


SDA$_SUCCESS Indicates a successful completion. 

SDA$_CNFLTARGS Indicates more than twenty FAO parameters 
given. 

Other Returns from the $PUT issued by SDA$¢PRINT 


(the error is also signaled). If the $FAOL_64 call 
issued by SDA$PRINT fails, the control string is 
output. 
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Example 
char buffer[32]; 
sda$get_block name (0x6F, 0x20, 
buffer, 


sizeof (buffer) ); 
sdaSprint ("Block type: !AZ", buffer); 


This example outputs the following line: 


Block type: VCC_CFCB 


10-48 SDA Callable Routines Extension 


SDA Callable Routines Extension 
SDA$READ_SYMFILE 


SDA$READ_SYMFILE 


Reads symbols from a given file. 


Format 

int sda$read_symfile (char *filespec, uint82 options, __optional_params); 
Arguments 

filespec 

OpenVMS usage _ char_string 

type character string 

access read only 

mechanism by reference 


Address of file or directory specification from which to read the symbols (zero- 
terminated ASCII string). 


options 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Indicates type of symbol file and flags, as shown in the following: 


Flags Effect 

SDA _OPT$M READ FORCE read/force <file> 

SDA_OPT$M READ IMAGE read/image <file> 

SDA_OPT$M READ SYMVA read/symva <file> 

SDA _OPT$M READ RELO read/relo <file> 

SDA _OPT$M READ EXEC read/exec [<dir>] 
SDA_OPT$M_READ_NOLOG /nolog, suppress count of symbols read 
SDA _OPT$M READ FILESPEC <file> or <dir> given 
SDA_OPT$M_READ_NOSIGNAL return status, without signaling errors 


relocate_base 
OpenVMS usage _ address 


type longword (unsigned) 
access read only 
mechanism by value 


Base address for symbols (nonsliced symbols). 


symvect_va 

OpenVMS usage _ address 

type longword (unsigned) 
access read only 
mechanism by value 


The symbol vector address (symbols are offsets into the symbol vector). 
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Description 


symvect_size 
OpenVMS usage longword_unsigned 


type longword (unsigned) 
access read only 
mechanism by value 


Size of symbol vector. 


loaded_img_info 
OpenVMS usage _ address 


type longword (unsigned) 
access read only 
mechanism by reference 


The address of $LDRIMG data structure with execlet information. 


This command reads symbols from a given file to add symbol definitions to the 
working symbol table by reading GST entries. The file is usually a symbol file 
(.STB) or an image (.EXE). If SDA_OPT$M_READ_EXEC is specified in the 
options, then the filespec is treated as a directory specification, where symbol files 
and/or image files for all execlets may be found (as with READ/EXECUTIVE). If 
no directory specification is given, the logical name SDA$READ_DIR is used. 


Note that when SDA reads symbol files and finds routine names, the symbol 
name that matches the routine name is set to the address of the procedure or 
function descriptor. A second symbol name, the routine name with "_C" appended, 
is set to the start of the routine’s prologue. 


Condition Values Returned 


Example 


SDA$_SUCCESS Successful completion. 
SDA$_CNFLTARGS No filename given and SDA_OPT$M_READ_ 
EXEC not set. 


Others errors are signaled and/or returned, exactly as though the equivalent SDA 
READ command had been used. Use HELP/MESSAGE for explanations. 


sda$read_symfile ("SDASREAD DIR:SYSDEF", SDA_OPTSM_READ NOLOG) ; 


The symbols in SYSDEF.STB are added to SDA’s internal symbol table, and the 
number of symbols found is not output to the terminal. 
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SDAS$REQMEM 


Format 


Arguments 


Description 


Reads dump or system memory and signals an error if inaccessible. 


int sda$reqmem (VOID_PQ start, void *dest, int length optional_params); 


start 

OpenVMS usage _ address 

type quadword (unsigned) 
access read only 
mechanism by value 


Starting virtual address in dump or system. 


dest 

OpenVMS usage _ address 
type varies 
access write only 
mechanism by reference 


Return buffer address. 


length 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Length of transfer. 


physical 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


0: <start> is a virtual address. This is the default. 
1: <start> is a physical address. 


This routine transfers an area from the memory in the dump file or the running 
system to the caller’s return buffer. It performs the necessary address translation 
to locate the data in the dump file. SDA$REQMEM signals an error and aborts 
the current command if the data is inaccessible. 


Related Routines 
SDA$GETMEM and SDA$TRYMEM 
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Condition Values Returned 


SDA$_SUCCESS Successful completion. 


Any failure is signaled as an error and the current command aborts. 


Example 


VOID_PQ address; 
uint32 instruction; 


sda$symbol value ("EXE STDSALLOCATE C", (uint64 *)&address); 
sda$reqmem (address, &instruction, 4); 


This example reads the first instruction of the routine EXE_STD$ALLOCATE 
into the location INSTRUCTION. 
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SDA$SET_ADDRESS 


Stores a new address value as the current memory address ("."). 


Format 

void sda$set_address (VOID_PQ address); 
Argument 

address 

OpenVMS usage quadword_unsigned 

type quadword (unsigned) 

access read only 

mechanism by value 

Address value to store in current memory location. 
Description 


The specified address becomes SDA’s current memory address (the predefined 
SDA symbol "."). 


Condition Values Returned 


None 


Example 


sda$set_address ((VOID_ PQ)0xFFFFFFFF80102030); 
This call sets SDA’s current address to FFFFFFFF.80102030. 


SDA Callable Routines Extension 10-53 


SDA Callable Routines Extension 
SDA$SET_CPU 


SDA$SET_CPU 


Format 


Arguments 


Description 


Sets a new SDA CPU context. 


int sda$set_cpu (int cpu_id); 


cpu_id 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


The desired CPU ID. 


This routine causes SDA to set the specified CPU as the currently selected CPU. 


Condition Values Returned 


Example 


SDA$_SUCCESS Successful completion. 


Any failure is signaled as an error and the current command aborts. 


int cpu_id = 2; 
status = sdaSset_cpu ( cpu_id ); 


In this example, SDA’s current CPU context is set to the CPU whose number is 
held in the variable CPU_ID. 
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SDA$SET_HEADING_ROUTINE 


Format 


Argument 


Description 


Sets the current heading routine to be called after each page break. 


void sda$set_heading_routine (void (*“heading_rtn) ()); 


heading_rtn 

OpenVMS usage procedure 
type rocedure value 
access read only 
mechanism by value 


Address of routine to be called after each new page. 


When SDA begins a new page of output (either because SDA$SNEW_PAGE was 
called, or because the current page is full), it outputs two types of headings. The 
first is the page title, and is set by calling the routine SDA$FORMAT_HEADING. 
This is the title that is included in the index page of a listing file when you issue 
a SET OUTPUT command. The second heading is typically for column headings, 
and as this can vary from display to display, you must write a routine for each 
separate heading. When you call SDA$SET_HEADING_ROUTINE to specify a 
user-written routine, the routine is called each time SDA begins a new page. 


To stop the routine from being invoked each time SDA begins a new page, 
call either SDA$SFORMAT_HEADING to set a new page title, or SDA$SET_ 
HEADING_ROUTINE and specify the routine address as NULL. 


If the column headings need to be output during a display (that is, in the middle 

of a page), and then be re-output each time SDA begins a new page, call the user- 
written routine directly the first time, then call SDA$SET_HEADING_ROUTINE 
to have it be called automatically thereafter. 


Condition Values Returned 


None 
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Example 
void mbx$title (void) 

{ 

sdaSprint ("Mailbox UCB ae ie 
sdaSprint (" Unit Address ven” a 
sda$print ("------------------------ mye 
return; 

} 


sda$set_heading routine (mbx$title); 
sda$set_heading routine (NULL); 


This example sets the heading routine to the routine MBX$TITLE, and 
later clears it. The routine is called if any page breaks are generated by the 
intervening code. 
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SDA$SET_LINE_COUNT 


Sets the number of lines printed so far on the current page. 


Format 

void sda$set_line_count (uint32 line_count); 
Argument 

line_count 

OpenVMS usage longword_unsigned 

type longword (unsigned) 

access read only 

mechanism by value 

The number of lines printed on current page. 
Description 


The number of lines that have been printed so far on the current page is set to 
the given value. 


Condition Values Returned 
None 


Example 


sda$set_line count (5); 


This call sets SDA’s current line count on the current page of output to 5. 
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SDA$SET_PROCESS 


Format 


Arguments 


Description 


Sets a new SDA process context. 


int sda$set_process (const char *proc_name, int proc_index, int proc_addr); 


proc_name 

OpenVMS usage _ character_string 
type character string 
access read only 
mechanism by reference 


Address of the process name string (zero-terminated). 


proc_index 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


The index of the desired process. 


proc_addr 

OpenVMS usage _ address 

type longword (unsigned) 
access read only 
mechanism by value 


The address of the PCB for the desired process. 


This routine causes SDA to set the specified process as the currently selected 
process. 


Note 


The proc_name, proc_index, and proc_addr are mutually exclusive. 


Condition Values Returned 


Example 


SDA$_SUCCESS Successful completion. 


Any failure is signaled as an error and the current command aborts. 


status = sda$set_process (| "JOB_CONTROL", 0, 0); 


In this example, SDA’s current process context is set to the JOB_CONTROL 
process. 
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SDAS$SKIP_LINES 


This routine outputs a specified number of blank lines. 


Format 
void sda$skip_lines (uint32 lines); 
Argument 
lines 
OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 
Number of lines to skip. 
Description 


The specified number of blank lines are output. 


Condition Values Returned 


None 
Example 


sda$skip lines (2); 


This call causes two blank lines to be output. 
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SDA$SYMBOL_VALUE 


Obtains the 64-bit value of a specified symbol. 


Format 
int sda$symbol_value (char *symb_name, uint64 *symb_value); 
Arguments 
symb_name 
OpenVMS usage _ char_string 
type character string 
access read only 
mechanism by reference 
Zero-terminated string containing symbol name. 
symb_value 
OpenVMS usage quadword_unsigned 
type quadword (unsigned) 
access write only 
mechanism by reference 
Address to receive symbol value. 
Description 


A search through SDA’s symbol table is made for the specified symbol. If found, 
its 64-bit value is returned. 


Condition Values Returned 


SDA$_SUCCESS Symbol found. 

SDA$ BADSYM Symbol not found. 
Example 

int status; 


VOID_PQ address; 
status = sdaSsymbol value ("EXE STDSALLOCATE C", (uint64 *)&address); 


This call returns the start address of the prologue of routine 
EXE_STD$ALLOCATE to location ADDRESS. 
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SDA$SYMBOLIZE 


Format 


Arguments 


Description 


Converts a value to a symbol name and offset. 


int sda$symbolize (uint64 value, char *symbol_buf, uint82 symbol_len); 


value 

OpenVMS usage quadword_unsigned 
type quadword (unsigned) 
access read only 
mechanism by value 


Value to be translated. 


symbol_buf 

OpenVMS usage _ char_string 
type character string 
access write only 
mechanism by reference 


Address of buffer to which to return string. 


symbol_len 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Maximum length of string buffer. 


This routine accepts a value and returns a string that contains a symbol and 
offset corresponding to that value. First the value is checked in the symbol 
table. If no symbol can be found (either exact match or up to OXFFF less than 
the specified value), the value is then checked to see if it falls within one of the 
loaded or activated images. 


Condition Values Returned 


SS$_NORMAL Successful completion. 

SS$_BUFFEROVF Buffer too small, string truncated. 

SS$_NOTRAN No symbolization for this value (null string 
returned). 
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Example 
VOID PQ va = VOID_PQ(0XFFFFFFFF80102030); 
char buffer [64] 


status = sdaSsymbolize (va, buffer, sizeof(buffer) ); 
sda$print ("FFFFFFFF.80102030 = \"!Az\"", buffer); 


This example outputs the following: 


FFFFFFFF.80102030 = "EXESWRITE PROCESS C+00CDO0" 
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SDAS$TRYMEM 


Format 


Arguments 


Description 


Reads dump or system memory and returns the error status (without signaling) if 
inaccessible. 


int sda$trymem (VOID_PQ start, void *dest, int length optional_params); 


Deo 


start 

OpenVMS usage _ address 

type quadword (unsigned) 
access read only 
mechanism by value 


Starting virtual address in dump or system. 


dest 

OpenVMS usage _ address 
type varies 
access write only 
mechanism by reference 


Return buffer address. 


length 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


Length of transfer. 


physical 

OpenVMS usage longword_unsigned 
type longword (unsigned) 
access read only 
mechanism by value 


0: <start> is a virtual address. This is the default. 
1: <start> is a physical address. 


This routine transfers an area from the memory in the dump file or the running 
system to the caller’s return buffer. It performs the necessary address translation 
to locate the data in the dump file. SDA$STRYMEM does not signal any warning 
or errors. It returns the error status if the data is inaccessible. 


Related Routines 
SDA$GETMEM and SDA$REQMEM 
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Condition Values Returned 


SDA$_SUCCESS 
SDA$ NOREAD 
SDA$ NOTINPHYS 
Others 


Example 


int status; 
DDB *ddb; 


Successful completion. 

The data is inaccessible for some reason. 
The data is inaccessible for some reason. 
The data is inaccessible for some reason. 


status = sdaStrymem (ddb->ddb$ps link, ddb, DDBSK LENGTH); 
if ($VMS STATUS SUCCESS (status) ) 
sdaSprint ("Next DDB is successfully read from dump"); 


else 


sda$print ("Next DDB is inaccessible"); 


This example attempts to read the next DDB in the DDB list from the dump. 
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SDASTYPE 


Format 


Arguments 


Description 


Formats and types a single line to SYS$OUTPUT. 


int sda$type (char “ctrstr, __ optional_params); 


an 


ctrstr 

OpenVMS usage _ char_string 

type character-coded text string 
access read only 

mechanism by reference 


Address of a zero-terminated FAO control string. 


prmlist 

OpenVMS usage varying_arg 

type quadword (signed or unsigned) 
access read only 

mechanism by value 


Optional FAO parameters. All arguments after the control string are copied into 
a quadword parameter list, as used by $FAOL_64. 


Formats and prints a single line to the terminal. This is unaffected by the use of 
the SDA commands SET OUTPUT or SET LOG. 


Condition Values Returned 


Example 


SDA$_SUCCESS Indicates a successful completion. 

SDA$_CNFLTARGS Indicates more than twenty FAO parameters 
given. 

Other Returns from the $PUT issued by SDA$TYPE 


(the error is also signaled). If the $FAOL_64 call 
issued by SDA$TYPE fails, the control string is 
output. 


int status; 
status = sdaStype ("Invoking SHOW SUMMARY to output file..."); 


This example displays the message "Invoking SHOW SUMMARY to output file..." 
to the terminal. 
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SDA$VALIDATE_QUEUE 


Format 


Arguments 


Description 


Validates queue structures. 


void sda$validate_queue (VOID_PQ queue_header, __optional_params); 


queue_header 
OpenVMS usage _ address 


type quadword (unsigned) 
access read only 
mechanism by value 


Address from which to start search. 


options 

OpenVMS usage mask_longword 
type longword (unsigned) 
access read only 
mechanism by value 


The following table shows the flags that indicate the type of queue: 


Flag Meaning 

None Defaults to doubly-linked 
longword queue 

SDA_OPT$M_QUEUE_BACKLINK Validates the integrity of a doubly- 


linked queue using the back links 
instead of the forward links 


SDA_OPT$M_QUEUE_LISTQUEUE Displays queue elements for 
debugging 
SDA_OPT$M_QUEUE_QUADLINK Indicates a quadword queue 
SDA_OPT$M_QUEUE_SELF Indicates a self-relative queue 
SDA_OPT$M_QUEUE_SINGLINK Indicates a singly-linked queue 


You can use this routine to validate the integrity of doubly-linked, singly-linked 
or self-relative queues either with longword or quadword links. If you specify the 
option SDA_OPT$M_QUEUE_LISTQUEUE, the queue elements are displayed 
for debugging. Otherwise a one-line summary indicates how many elements were 
found and whether the queue is intact. 


Condition Values Returned 


None 


If an error occurs, it is signaled by SDA$VALIDATE_QUEUE. 
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Example 


int64 temp; 

int64 *queue; 

sdaSsymbol value ("EXESGL NONPAGED", &temp); 

temp t= 4; ~ 

sdaSreqmem ((VOID PQ)temp, &queue, 4); 
sda$validate_queue (queue, SDA_OPTSM QUEUE _SINGLINK) ; 


This sequence validates the nonpaged pool free list, and outputs a message of the 
form: 


Queue is zero-terminated, total of 204 elements in the queue 
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OpenVMS Alpha System Code Debugger and 


System Dump Debugger 


Part II describes the System Code Debugger (SCD) and the System Dump 
Debugger (SDD). It presents how to use SCD and SDD by doing the following: 


Building a system image to be debugged 

Setting up the target system for connections 
Setting up the host system 

Starting SCD 

Troubleshooting connections and network failures 
Looking at a sample SCD session 

Analyzing memory as recorded in a system dump 


Looking at a sample SDD session 
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OpenVMS System Code Debugger 


This chapter describes the OpenVMS System Code Debugger (SCD) and how it 
can be used to debug nonpageable system code and device drivers running at any 
interrupt priority level (IPL). 


You can use SCD to perform the following tasks: 


e Control the system software’s execution—-stop at points of interest, resume 
execution, intercept fatal exceptions, and so on 


e Trace the execution path of the system software 
e Monitor exception conditions 
e Examine and modify the values of variables 


e Test the effect of modifications, in some cases, without having to edit the 
source code, recompile, and relink 


The use of SCD requires two systems: 


e The host system, probably also the system where the image to be debugged 
has been built 


e The target system, usually a standalone test system, where the image being 
debugged is executed 


e Host and target systems must be the same architecture, that is, both must be 
Alpha systems or I64 systems. 


SCD is a symbolic debugger. You can specify variable names, routine names, and 
so on, precisely as they appear in your source code. SCD can also display the 
source code where the software is executing, and allow you to step by source line. 


SCD recognizes the syntax, data typing, operators, expressions, scoping rules, 
and other constructs of a given language. If your code or driver is written in more 
than one language, you can change the debugging context from one language to 
another during a debugging session. 


To use SCD, you must do the following: 
e Build a system image or device driver to be debugged. 


e Set up the target kernel on a standalone system. 


The target kernel is the part of SCD that resides on the system that is being 
debugged. It is integrated with XDELTA and is part of the SYSTEM_DEBUG 
execlet. 


e Set up the host system environment, which is integrated with the OpenVMS 
Debugger. 
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The following sections cover these tasks in more detail, describe the available 
user-interface options, summarize applicable OpenVMS Debugger commands, and 
provide a sample SCD session. 


11.1 User-Interface Options 


SCD has the following user-interface options: 


A DECwindows Motif interface for workstations 


When using this interface, you interact with SCD by using a mouse and 
pointer to choose items from menus, click on buttons, select names in 
windows, and so on. 


Note that you can also use OpenVMS Debugger commands with the 
DECwindows Motif interface. 


A character cell interface for terminals and workstations 


When using this interface, you interact with SCD by entering commands at 
a prompt. The sections in this chapter describe how to use the system code 
debugger with the character cell interface. 


For more information about using the OpenVMS DECwindows Motif interface 
and OpenVMS Debugger commands with SCD, see the HP OpenVMS Debugger 
Manual. 


11.2 Building a System Image to Be Debugged 


1. 


Compile the sources you want to debug, and be sure to use the /DEBUG and 
/NOOPT qualifiers. 


Note 


Debugging optimized code is much more difficult and is not recommended 
unless you know the Alpha or 164 architecture well. The instructions are 
reordered so much that single-stepping by source line will look like you 
are randomly jumping all over the code. Also note that you cannot access 
all variables. SCD reports that they are optimized away. 


Link your image using the /DSF (debug symbol file) qualifier. Do not use the 
/DEBUG qualifier, which is for debugging user programs. The /DSF qualifier 
takes an optional filename argument similar to the /EXE qualifier. For more 
information, see the HP OpenVMS Linker Utility Manual. If you specify a 
name in the /EXE qualifier, you will need to specify the same name for the 
/DSF qualifier. For example, you would use the following command: 


$ LINK/EXE=EXE$ :MY_EXECLET/DSF=EXE$ :MY_EXECLET OPTIONS FILE/OPT 


The .DSF and .EXE file names must be the same. Only the extensions will be 
different, that is .DSF and .EXE. 


The contents of the .EXE file should be exactly the same as if you had linked 
without the /DSF qualifier. The .DSF file will contain the image header and 
all the debug symbol tables for .EXE file. It is not an executable file, and 
cannot be run or loaded. 


Put the .EXE file on your target system. 
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4. Put the .DSF file on your host system, because when you use SCD to debug 
code in your image, it will try to look for a .DSF file first and then look for an 
.EXE file. The .DSF file is better because it has symbols in it. Section 11.4 
describes how to tell SCD where to find your .DSF and .EXE files. 


11.3 Setting Up the Target System for Connections 


The target kernel is controlled by flags and devices specified when the system 
is booted, by XDELTA commands, by a configuration file, and by several system 
parameters. The following sections contain more information about these items. 


Boot Flags 


You can specify flags on the boot command line. Boot flags are specified as a hex 
number; each bit of the number represents a true or false value for a flag. The 
following flag values are relevant to the system code debugger. 


e 8000 


This is the SCD boot flag. It enables operation of the target kernel. If this 
SCD boot flag is not set, not only will it be impossible to use SCD to debug the 
system, but the additional XDELTA commands related to the target kernel 
will generate an XDELTA error message. If this boot flag is set, SYSTEM_ 
DEBUG is loaded, and SCD is enabled. 


¢ 0004 


This is the initial breakpoint boot flag. It controls whether the system calls 
INI$BRK at the beginning and end of EXEC_INIT. Notice that if SCD is the 
default debugger, the first breakpoint is not as early as it is for XDELTA. It is 
delayed until immediately after the PFN database is set up. 


¢ 0002 


This is the XDELTA boot flag, which controls whether XDELTA is loaded. It 
behaves slightly differently when the SCD boot flag is also set. 


If the SCD boot flag is clear, this flag simply determines if XDELTA is 
loaded. If the SCD boot flag is set, this flag determines whether XDELTA 
or the system code debugger is the default debugger. If the XDELTA flag is 
set, XDELTA will be the default debugger. In this state, the initial system 
breakpoints and any calls to INI$BRK trigger XDELTA, and you must enter 
an XDELTA command to start using SCD. If the XDELTA boot flag is clear, 
the initial breakpoints and calls to INI$BRK go to SCD. You cannot use 
XDELTA if the XDELTA boot flag is clear. 


Boot Command 


The form of the boot command varies depending on the platform and type 
OpenVMS system. However, all SCD boot commands have the concept of boot 
flags, boot device, and dedicated Ethernet device. In all environments, you must 
specify an Ethernet device on the target system to use to communicate with the 
host debugger. It is currently a restriction that this device must not be used for 
anything else (either for booting or network software such as DECnet, TCP/IP 
products, and LAT products). 


To use Alpha SCD, you must specify the Ethernet device with boot command. In 
this example, we are using DEC 3000 Model 400 Alpha Workstation syntax. We 
are booting from the DKB100 disk and using the ESAO Ethernet device. We are 
also setting the SCD, XDELTA, and initial (earliest) breakpoint flags: 
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>>> show device 


>>> boot dkb100,esa0 -f1 0,8006 


You can set these devices and flags to be the default values so that you will not 


have to specify them each time you boot: 


>>> set bootdef_dev dkb100,esa0 
>>> set boot _osflags 0,8006 


To use 164 SCD, you can specify an Ethernet device (debug_dev) BEFORE loading 
the Operating System and AFTER you have selected the device/partition. Setting 
debug_dev is sticky. That is, you only need to set it once. Using a HP rx2600 


syntax: 
A sample 164 Boot Menu follows. 


Please select a boot option 


EFI Shell [Built-in] 
PESOS - X8.2-AHI (Topaz BL2) on $1$DGA3890:[SYS2. ] 


PESOS - X8.2-AHI (Topaz BL2) on $1$DGA3890:[SYS2.] sysboot 


PESOS - E8.2-ADH (Topaz BL1) on $1$DGA3891:[SYS2. ] 


PESOS - E8.2-ADH (Topaz BL1) on $1$DGA3891:[SYS2.] sysboot 


Boot Option Maintenance Menu 
System Configuration Menu 


Select the EFI Shell [Built-in]. 


Loading.: EFI Shell [Built-in] 
EFI Shell version 1.10 [14.61] 
Device mapping table 


fs0 : Acpi(HWP0002,100)/Pci(1]0 
fsl =: Acpi(HWP0002,300)/Pci(1}0 
fs2. : Acpi(HWP0002,300)/Pci(1}0 

(1/0 


fs3: Acpi(HWP0002,300)/Pci 


Shell> 
Select the desired device/partition: 


Shell> fsl: 
fsl:\> 


)/Scsi(Pun0,Lun0) /HD(Part1,SigA02952 
) /Fibre (WWN50001FE10011B15D,Lun2200) 
) /Fibre (WWN50001FE10011B15D,Lun2200) 
) /Fibre (WWN50001FE10011B15D,Lun2300) 


Use the utilities in \efi\vms. Use vms_show to list the devices and vms_set to 


set Ethernet device (debug_dev), if necessary. 


fs1:\> \efi\vms\vms_show device 
VMS: EIAO 
EFI: Acpi(000222F0,0)/Pci(3|0)/Mac(00306E39F77B) 


VMS: DKB200 


EFI: fsl: Acpi(000222F0,100)/Pci(1|1)/Scsi(Pun2,Lun0) 


VMS: DKBO 


EFI: fs0: Acpi(000222F0,100)/Pci(1|1)/Scsi(Pun0,Lun0) 


VMS: EWAO 
EFI: Acpi(000222F0,100)/Pci(2|0)/Mac(00306E3977C5) 
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Set the Ethernet device. 


fsl:\> \efi\vms\vms set debug dev eia0 
VMS: EIAO 0-30-6E-39-F7-CF 
EFI: Acpi(000222F0,0)/Pci(3|0)/Mac(00306E39F7CF) 


Finally, load the OS. In this example, the boot is with the SCD and initial 
(earliest) breakpoint flags using root 2 (SYS2), that will vary with system setups. 


fs1:\> \efi\vms\vms_loader -flags "2,8004" 


You can set the flags to be the default value instead of specifying them for each 
and every OS load: 


fsl:\> set vms flags "2,8004" 


You can also build the entire boot device, OS load command with flags setting as 
a Boot Option. See the Boot Option Maintenance Menu. 


SCD Configuration File 


The SCD target system reads a configuration file in SYS$SYSTEM named 
DBGTK$CONFIG.SYS. The first line of this file contains a default password, 
which must be specified by the host debug system to connect to the target. The 
default password may be the null string; in this case the host must supply 

the null string as the password (/PASSWORD="") on the connect command as 
described in Section 11.5, or no password at all. Other lines in this file are 
reserved by HP. Note that you must create this file because HP does not supply 
it. If this file does not exist prior to booting with SCD enabled, you can only run 
SCD by specifying a default password with the XDELTA ;R command described 
in the following section. 


XDELTA Commands 


When the system is booted with both the XDELTA boot flag and the SCD boot 
flag, the following two additional XDELTA commands are enabled: 


e n,\xxxx;R ContRol SCD connection 
You can use this command to do the following: 
— Change the password which the SCD host must present 
— Disconnect the current session from SCD 
— Give control to SCD by simulating a call to INISBRK 
— Any combination of these 


Optional string argument xxxx specifies the password that the system code 
debugger must present for its connection to be accepted. If this argument is 
left out, the required password is unchanged. The initial password is taken 
from the first line of the SYS$SYSTEM:DBGTK$CONFIG.SYS file. The new 
password does not remain in effect across a boot of the target system. 
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The optional integer argument n controls the behavior of the ;R command as 
follows: 


Value of N Action 

+1 Gives control to SCD by simulating a call to INI$SBRK 

+2 Returns to XDELTA after changing the password. 2;R without a 
password is a no-op 

0 Performs the default action 

-1 Changes the password, breaks any existing connection to SCD, 


and then simulates a call to INI$BRK (which will wait for a new 
connection to be established and then give control to SCD) 


-2 Returns to XDELTA after changing the password and breaking an 
existing connection 


Currently, the default action is the same action as +1. 


If SCD is already connected, the ;R command transfers control to SCD, and 
optionally changes the password that must be presented the next time a 
system code debugger tries to make a connection. This new password does 
not last across a boot of the target system. 


n;K Change inibrK behavior 


If optional argument n is 1, future calls to INI$BRK will result in a 
breakpoint being taken by SCD. If the argument is 0, or no argument is 
specified, future calls to INI$BRK will result in a breakpoint being taken by 
XDELTA. 


SYSTEM Parameters 


DBGTK_SCRATCH 


Bits 0 through 7 specify how many pages of memory are allocated for SCD. 
This memory is allocated only if system code debugging is enabled with the 
SCD boot flag (described earlier in this section). Usually, the default value of 
1 is adequate; however, if SCD displays an error message, increase this value. 


Bits 8 through 31 are reserved by HP. 


SCSNODE 


Identifies the target kernel node name for SCD. See Section 11.3.1 for more 
information. 


POOLPAGING 


If the image you are debugging uses paged pool, set POOLPAGING to zero to 
ensure that paged pool is always resident in memory. SCD cannot examine or 
deposit to any locations in paged pool that are not currently valid. 


S0_PAGING 


If the image you are debugging includes pageable code or data, set SO_ 
PAGING to 3 to ensure that such code and data are always resident in 
memory. SCD cannot examine, deposit to, set breakpoints at, and so on, any 
locations in pageable sections that are not currently valid. [This applies only 
to Alpha. I64 executive images and drivers do not contain pageable code or 
data.] 


11-6 OpenVMS System Code Debugger 


OpenVMS System Code Debugger 
11.3 Setting Up the Target System for Connections 


11.3.1 Making Connections Between the Target Kernel and the System Code 
Debugger 


It is always SCD on the host system that initiates a connection to the target 
kernel. When SCD initiates this connection, the target kernel accepts or rejects 
the connection based on whether the remote debugger presents it with a node 
name and password that matches the password in the target system (either 
the default password from the SYS$SYSTEM:DBGTK$CONFIG.SYS file, or a 
different password specified via XDELTA). SCD obtains the node name from the 
SCSNODE system parameter. 


The target kernel can accept a connection from SCD any time the system is 
running below IPL 22, or if XDELTA is in control (at IPL 31). However, the 
target kernel actually waits at IPL 31 for a connection from the SCD host 

in two cases: when it has no existing connection to an SCD host and (1) it 
receives a breakpoint caused by a call to INI$BRK (including either of the initial 
breakpoints), or (2) when you enter a 1;R or -1;R command to XDELTA. 


11.3.2 Interactions Between XDELTA and the Target Kernel/System Code 
Debugger 


XDELTA and the target kernel are integrated into the same system. Normally, 
you choose to use one or the other. However, XDELTA and the target kernel can 
be used together. This section explains how they interoperate. 


The XDELTA boot flag controls which debugger (XDELTA or the SCD target 
kernel) gets control first. If it is not set, the target kernel gets control first, and 
it is not possible to use XDELTA without rebooting. If it is set, XDELTA gets 
control first, but you can use XDELTA commands to switch to the target kernel 
and to switch INI$BRK behavior such that the target kernel gets control when 
INI$BRK is called. 


Breakpoints always stick to the debugger that set them; for example, if you set a 
breakpoint at location “A” with XDELTA, and then you enter the commands 1;K 
(switch INI$BRK to the system code debugger) and ;R (start using the system 
code debugger) then, from SCD, you can set a breakpoint at location “B”. If the 
system executes the breakpoint at A, XDELTA reports a breakpoint, and SCD 
will see nothing (though you could switch to SCD by issuing the XDELTA ;R 
command). If the system executes the breakpoint at B, SCD will get control and 
report a breakpoint (you cannot switch to XDELTA from SCD). 


Notice that if you examine location A with SCD, or location B with XDELTA, you 
will see a BPT instruction, not the instruction that was originally there. This is 
because neither debugger has any information about the breakpoints set by the 
other debugger. 


One useful way to use both debuggers together is when you have a system that 
exhibits a failure only after hours or days of heavy use. In this case, you can boot 
the system with SCD enabled (8000), but with XDELTA the default (0002) and 
with initial breakpoints enabled (0004). When you reach the initial breakpoint, 
set an XDELTA breakpoint at a location that will only be reached when the error 
occurs. Then proceed. When the error breakpoint is reached, possibly days later, 
then you can set up a remote system to debug it and enter the ;R command to 
XDELTA to switch control to SCD. 
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Here is another technique to use on Alpha when you do not know where to put 
an error breakpoint as previously mentioned. Boot the system with only the SCD 
boot flag set. When you see that the error has occurred, halt the system and 
initiate an IPL 14 interrupt, as you would to start XDELTA. The target kernel 
will get control and wait for a connection for SCD. 


11.4 Setting Up the Host System 


To set up the host system, you need access to all system images and drivers that 
are loaded (or can be loaded) on the target system. You should have access to a 
source listings kit or a copy of the following directories: 


SYS$LOADABLE_IMAGES: 
SYS$LIBRARY: 
SYS$MESSAGE: 


You need all the .EXE files in those directories. The .DSF files are available with 
the OpenVMS Alpha source listings kit. 


Optionally, you need access to the source files for the images to be debugged. 
SCD will look for the source files in the directory where they were compiled. If 
your build system and host system are different, you must use the SET SOURCE 
command to point SCD to the location of the source code files. For an example of 
the SET SOURCE command, see Section 11.12. 


Before making a connection to the target system, you must set up the logical 
name DBGHK$IMAGE_PATH, which must be set up as a search list to the area 
where the system images or .DSF files are kept. For example, if the copies are in 
the following directories: 


DEVICE: [SYS$LDR] 


DEVICE: [SYSLIB] 
DEVICE: [SYSMSG] 


you would define DBGHK$IMAGE_PATH as follows: 
$ define dbghk$image path DEVICE: [SYS$LDR], DEVICE: [SYSLIB] , DEVICE: [ SYSMSG] 


This works well for debugging using all the images normally loaded on a given 
system. However, you might be using the debugger to test new code in an execlet 
or a new driver. Because that image is most likely in your default directory, you 
must define the logical name as follows: 


$ define dbghk$image path [],DEVICE:[SYS$LDR] , DEVICE: [SYSLIB] , DEVICE: [ SYSMSG] 


If SCD cannot find one of the images through this search path, a warning 
message is displayed. SCD will continue initialization as long as it finds at least 
two images. If SCD cannot find the SYS$BASE_ IMAGE and SYS$PUBLIC_ 
VECTORS files, which are the OpenVMS operating system’s main image files, an 
error message is displayed and the debugger exits. 


If and when this happens, check the directory for the image files and compare it 
to what is loaded on the target system. 
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11.5 Starting the System Code Debugger 
To start SCD on the host side, enter the following command: 
$ DEBUG/KEEP 


SCD displays the DBG> prompt. With the DBGHK$IMAGE_PATH logical name 
defined, you can invoke the CONNECT command and the optional qualifiers 
/PASSWORD and /IMAGE_PATH. 


To use the CONNECT command and the optional qualifiers (PASSWORD and 
/IMAGE_PATH) to connect to the node with name nodename, enter the following 
command: 


DBG> CONNECT %NODE_NAME nodename /PASSWORD="password" 


If a password has been set up on the target system, you must use the 
/PASSWORD qualifier. If a password is not specified, a zero length string is 
passed to the target system as the password. 


The /IMAGE_PATH qualifier is also optional. If you do not use this qualifier, SCD 
uses the DBGHK$IMAGE_PATH logical name as the default. The /IMAGE_PATH 
qualifier is a quick way to change the logical name. However, when you use it, 
you cannot specify a search list. You can use only a logical name or a device and 
directory, although the logical name can be a search list. 


Usually, SCD obtains the source file name from the object file. This is put there 
by the compiler when the source is compiled with the /DEBUG qualifier. The SET 
SOURCE command can take a list of paths as a parameter. It treats them as a 
search list. 


11.6 Summary of System Code Debugger Commands 


In general, any OpenVMS debugger command can be used in SCD. For a 
complete list, refer to the HP OpenVMS Debugger Manual. The following are a 
few examples: 


e Commands to manipulate the source display, such as TYPE and SCROLL. 


e Commands used in OpenVMS debugger command programs, such as DO and 
IF. 


e Commands that affect output formats, such as SET RADIX. 


e Commands that manipulate symbols and scope, such as EVALUATE, SET 
LANGUAGE, and CANCEL SCOPE. Note that the debugger SHOW IMAGE 
command is equivalent to the XDELTA ;L command, and the debugger 
DEFINE command is equivalent to the XDELTA ;X command. 


¢ Commands that cause code to be executed, such as STEP and GO. Note 
that the debugger STEP command is equivalent to the XDELTA S and O 
commands, and the debugger GO command is equivalent to the XDELTA ;P 
and ;G commands. 


e Commands that manipulate breakpoints, such as SET BREAK and CANCEL 
BREAK. These commands are equivalent to the XDELTA ;B command. 
However, unlike XDELTA, there is no limit on the number of breakpoints in 


SCD. 
e Commands that affect memory, such as DEPOSIT and EXAMINE. These 
commands are equivalent to the XDELTA /,!,[,",’ commands. 
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You can also use the OpenVMS debugger command SDA to examine the target 
system with System Dump Analyzer semantics. This command, which is not 
available when debugging user programs, is described in the next section. 


11.7 Using System Dump Analyzer Commands 


Once a connection has been established to the target system, you can use the 
commands listed in the previous section to examine the target system. You 
can also use some System Dump Analyzer (SDA) commands, such as SHOW 
SUMMARY and SHOW DEVICE. This feature allows the system programmer 
to take advantage of the strengths of both the OpenVMS Debugger and SDA to 
examine the state of the target system and to debug system programs such as 
device drivers. 


To obtain access to SDA commands, you simply type "SDA" at the OpenVMS 
Debugger prompt ("DBG>") at any time after a connection has been established 
to the target system. SDA initializes itself and then outputs the "SDA>" prompt. 
Enter SDA commands as required. (See Chapter 4 for more information.) To 
return to the OpenVMS Debugger, you enter "EXIT" at the "SDA>" prompt. 
Optionally, you may invoke SDA to perform a single command and then return 
immediately to the OpenVMS Debugger, as in the following example: 


DBG>SDA SHOW SUMMARY 


You may reenter SDA at any time, with or without the optional SDA command. 
Once SDA has been initialized, the SDA> prompt is output more quickly on 
subsequent occasions. 


Note that there are some limitations on the use of SDA from within SCD. 


e You cannot switch between processes, whether requested explicitly (SET 
PROCESS <name>) or implicitly (SHOW PROCESS <name>). The exception 
to this is that access to the system process is possible. 


e You cannot switch between CPUs. 


e SDA has no knowledge of the OpenVMS debugger’s Motif or Windows 
interfaces. Therefore, all SDA input and output occurs at the terminal or 
window where the OpenVMS debugger was originally invoked. Also, while 
using SDA, the OpenVMS debugger window is not refreshed; you must exit 
SDA to allow the OpenVMS debugger window to be refreshed. 


e When you invoke SDA from SCD with an immediate command, and that 
command produces a full screen of output, SDA displays the message "Press 
RETURN for more." followed by the "SDA>" prompt before continuing. If you 
enter another SDA command at this prompt, SDA does not automatically 
return to SCD upon completion. To do this, you must enter an EXIT 
command. 


11.8 System Code Debugger Network Information 


The SCD host and the target kernel use a private Ethernet protocol to 
communicate. The best way to ensure that the two systems can see each 
other is for them both to be on the same Ethernet segment. Otherwise, your 
network and its bridges must be set up to pass through the packets with the 
protocol 08-00-2B-80-4B and multicast address 09-00-2B-02-01-0F. 
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The network portion of the target system uses the specified Ethernet device and 
communicates through it. The network portion of the host system finds the first 
Ethernet device and communicates through it. If the host SCD picks the wrong 
device for your needs, then you can force it to use the correct device by defining 
the logical DBGHK$ADAPTOR as the template device name for the appropriate 
adaptor. 


11.9 Troubleshooting Checklist 


If you have trouble starting a connection, perform the following tasks to correct 
the problem: 


Check SCSNODE on the target system. 
It must match the name you are using in the host CONNECT command. 


Make sure that both the Ethernet and boot device have been specified 
correctly. 


Make sure that the host system is using the correct Ethernet device, and that 
the host and target systems are connected to the same Ethernet segment. 


Check the version of the operating system and make sure that both the host 
and target systems are running the same version of the OpenVMS operating 
system. 


11.10 Troubleshooting Network Failures 


There are three possible network errors: 


NETRETRY 


Indicates the system code debugger connection is lost 


SENDRETRY 
Indicates a message send failure 
NETFAIL 


Results from the two previous errors 


The netfail error message has a status code that can be one of the following 
values: 


Value Status 

2, 4,6 Internal network error, submit a problem report to HP. 

8,10,14,16,18,20,26,28,34,38 Network protocol error, submit a problem report to HP. 

22,24 Too many errors on the network device most likely due to congestion. 
Reduce the network traffic or switch to another network backbone. 

30 Target system scratch memory not available. Check DBGTK_SCRATCH. If 
increasing this value does not help, submit a problem report to HP. 

32 Ran out of target system scratch memory. Increase value of DBGTK_ 
SCRATCH. 

All others There should not be any other network error codes printed. If one occurs 


that does not match the previous ones, submit a problem report to HP. 
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11.11 Access to Symbols in OpenVMS Executive Images 


Accessing OpenVMS executive images’ symbols is not always straightforward 
with SCD. Only a subset of the symbols may be accessible at one time and 

in some cases, the symbol value the debugger currently has may be stale. To 
understand these problems and their solutions, you must understand how the 
debugger maintains its symbol tables and what symbols exist in the OpenVMS 
executive images. The following sections briefly summarize these topics. 


11.11.1 Overview of How the OpenVMS Debugger Maintains Symbols 


The debugger can access symbols from any image in the OpenVMS loaded system 
image list by reading in either the .DSF or .EXE file for that particular image. 
The .EXE file contains information only about symbols that are part of the symbol 
vector for that image. The current image symbols for any set module are defined. 
(You can tell if you have the .DSF or .EXE file by doing a SHOW MODULE. 

If there are no modules, you have the .EXE file.) This includes any symbols in 
the SYS$BASE_IMAGE.EXE symbol vector for which the code or data resides 

in the current image. However, you cannot access a symbol that is part of the 
SYS$BASE_IMAGE.EXE symbol vector that resides in another image. 


In general, at any one point in time, the debugger can access only the symbols 
from one image. It does this to reduce the time it takes to search for a symbol 
in a table. To load the symbols for a particular image, use the SET IMAGE 
command. When you set an image, the debugger loads all the symbols from 
the new image and makes that image the current image. The symbols from 
the previous image are in memory, but the debugger will not look through 
them to translate symbols. To remove symbols from memory for an image, 
use the CANCEL IMAGE command (which does not work on the main image, 
SYS$BASE_IMAGE). 


There is a set of modules for each image the debugger accesses. The symbol 
tables in the image that are part of these modules are not loaded with the SET 
IMAGE command. Instead they can be loaded with the SET MODULE <module- 
name> or SET MODULE/ALL commands. As they are loaded, a new symbol table 
is created in memory under the symbol table for the image. Figure 11—1 shows 
what this looks like. 


Figure 11-1 Maintaining Symbols 


Symbol Table Symbol Table 
for Image N-1 for Image N 
Module Module 

2 . M 


When the debugger needs to look up a symbol name, it first looks at the current 
image to find the information. If it does not find it there, it then looks into the 
appropriate module. It determines which module is appropriate by looking at the 
module range symbols which are part of the image symbol table. 


Current Image 


Symbol Table 
for Image 1 


Module 
1 


ZK-7460A-GE 
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To see the symbols that are currently loaded, use the debugger’s SHOW SYMBOL 
command. This command has a few options to obtain more than just the symbol 
name and value. (See the HP OpenVMS Debugger Manual for more details.) 


11.11.2 Overview of OpenVMS Executive Image Symbols 


Depending on whether the debugger has access to the .DSF or .EXE file, different 
kinds of symbols could be loaded. Most users will have the .EXE file for the 
OpenVMS executive images and a .DSF file for their private images—that is, the 
images they are debugging. 


The OpenVMS executive consists of two base images, SYS$BASE_IMAGE.EXE 
and SYS$PUBLIC_VECTORS.EXE, and a number of separately loadable 
executive images. 


The two base images contain symbol vectors. For SYS$BASE_IMAGE.EXE, the 
symbol vector is used to define symbols accessible by all the separately loadable 
images. This allows these images to communicate with each other through cross- 
image routine calls and memory references. For SYS$PUBLIC_VECTORS.EXE, 
the symbol vector is used to define the OpenVMS system services. Because these 
symbol vectors are in the .EXE and the .DSF files, the debugger can load these 
symbols no matter which one you have. 


All images in the OpenVMS executive also contain global and local symbols. 
However, none of these symbols ever gets into the .EXE file for the image. These 
symbols are put in the specific module’s section of the .DSF file if that module 
was compiled using /DEBUG and the image was linked using /DSF. 


11.11.3 Possible Problems You May Encounter 


e Access to All Executive Image Symbols 


When the current image is not SYS$BASE_IMAGE, but one of the separately 
loaded images, the debugger does not have access to any of the symbols in 
the SYS$BASE_IMAGE symbol vector. This means you cannot access (set 
breakpoints, and so on) any of the cross-image routines or data cells. The 
only symbols you have access to are the ones defined by the current image. 


If the debugger has access only to the .EXE file, then only symbols that have 
vectors in the base image are accessible. For .DSF files, the current image 
symbols for any set module are defined. (You can tell if you have the .DSF or 
.EXE by using the SHOW MODULE command—if there are no modules you 
have the .EXE). This includes any symbols in the SYS$BASE_IMAGE.EXE 
symbol vector for which the code or data resides in the current image. 
However, the user cannot access a symbol that is part of the SYS$BASE_ 
IMAGE.EXE symbol vector that resides in another image. For example, 

if you are in one image and you want to set a breakpoint in a cross-image 
routine from another image, you do not have access to the symbol. Of course, 
if you know in which image it is defined, you can do a SET IMAGH, SET 
MODULE/ALL, and then a SET BREAK. 


There is a debugger workaround for this problem. The debugger and SCD 
let you use the SET MODULE command on an image by prefixing the image 
name with SHARE$ (SHARE$SYS$BASE_IMAGE, for example). This treats 
that image as a module which is part of the current image. In the previous 
figure, think of it as another module in the module list for an image. Note, 
however, that only the symbols for the symbol vector are loaded. None of the 
symbols for the modules of the SHARE$xxx image are loaded. Therefore, this 
command is only useful for base images. 
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So, in other words, by doing SET MODULE SHARE$SYS$BASE_IMAGE, 
the debugger gives you access to all cross-image symbols for the OpenVMS 
executive. 


e Stale Data from the Symbol Vector 


When an OpenVMS executive based image is loaded, the values in the symbol 
vectors are only correct for information that resides in that based image. For 
all symbols that are defined in the separately loaded images, the based image 
contains a pointer to a placeholder location. For routine symbols this is a 
routine that just returns "an image not loaded" failure code. A symbol vector 
entry is fixed to contain the real symbol address when the image in which the 
data resides is loaded. 


Therefore, if you do a SET IMAGE command to a base image before all 

the symbol entries are corrected, the SET IMAGE obtains the placeholder 
value for those symbols. Then, once the image containing the real data is 
loaded, the debugger will still have the placeholder value. This means that 
you are looking at stale data. One solution to this is to make sure to do a 
SET IMAGE command on the base image in order to get the most up-to-date 
symbol vector loaded into memory. 


The CANCEL IMAGE/SET IMAGE combination does not currently work 

for SYS$BASE_IMAGE because it is the main image and DEBUG does not 
allow you to CANCEL the main image. Therefore, if you connect to the target 
system early in the boot process, you will have stale data as part of the 
SYS$BASE_IMAGE symbol table. However, the SET MODULE SHARE$xxx 
command always reloads the information from the symbol vector. So, to solve 
this problem you could SET IMAGE to an image other than SYS$BASE_ 
IMAGE and then use the CANCEL MODULE SHARES$SYS$BASE_IMAGE 
and SET MODULE SHARE$SYS$BASE_IMAGE commands to do the same 
thing. The only other solution is to always connect to the target system 
once all images are loaded that define the real data for values in the symbol 
vectors. You could also enter the following commands, and you would obtain 
the latest values from the symbol vector: 


SET IMAGE EXEC_INIT 
SET MODULE/ALL 
SET MODULE SHARESSYS$BASE_IMAGE 


¢ Problems with SYS$BASE_IMAGE.DSF 


For those who have access to the SYS$BASE_IMAGE.DSF file, there may 
be another complication with accessing symbols from the symbol vector. The 
problem is that the module SYSTEM_ROUTINES contains the placeholder 
values for each symbol in the symbol vector. So, if SYSTEM_ROUTINES is 
the currently set module (which is the case if you are sitting at the INI$SBRK 
breakpoint) then the debugger will have the placeholder value of the symbol 
as well as the value in the symbol vector. You can see what values are loaded 
with the SHOW SYMBOL/ADDRESS command. The symbol vector version 
should be marked with (global); the local one is not. 

To set a breakpoint at the correct code address for a routine when in this 
state, use the SHOW SYMBOL/ADDRESS command on the routine symbol 
name. If the global and local values for the code address are the same, then 
the image with the routine has not yet been loaded. If not, set a breakpoint 
at the code address for the global symbol. 
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11.12 Sample System Code Debugging Session 


This section provides a sample session that shows the use of some OpenVMS 
debugger commands as they apply to SCD. The examples in this session show 
how to work with C code that has been linked into the SYSTEM_DEBUG execlet. 
It is called as an initialization routine for SYSTEM_DEBUG. 


To reproduce this sample session, the host system needs access to the SYSTEM_ 
DEBUG.DSF matching the SYSTEM_DEBUG.EXE file on your target 

system, and to the source file C'TEST_ROUTINES.C, which is available in 
SYS$EXAMPLES. The target system is booted with the boot flags 0, 8004, so 

it stops at an initial breakpoint. The system disk is DKB200, and the network 
device is ESAO in the Alpha examples and EIAO in the 164 examples. 


Example 11-1 Booting an Alpha Target System 


>>> b -f1 0,8004 dkb200,esa0 
INIT-S-CPU... 
INIT-S-RESET TC... 
INIT-S-ASIC... 
INIT-S-MEM... 
INIT-S-NVR... 
INIT-S-SCC... 
INIT-S-NI... 
INIT-S-SCSI... 
INIT-S-ISDN... 
INIT-S-TCO... 

AUDIT BOOT STARTS ... 
AUDIT CHECKSUM GOOD 
AUDIT LOAD BEGINS 
AUDIT _LOAD DONE 


SSYSBOOT-I-GCTFIL, Using a configuration file to boot as a Galaxy instance. 


OpenVMS (TM) Alpha Operating System, Version V7.2 


DBGTK: Initialization succeeded. Remote system debugging is now possible. 


DBGTK: Waiting at breakpoint for connection from remote host. 


A sample 164 Boot Menu follows (long lines wrapped for clarity). 


Example 11-2 Booting an 164 Target System 


Please select a boot option 
EFI Shell [Built-in] 


PESOS - X8.2-AHI (Topaz BL2) on $1$DGA3890:[SYS2.] 


PESOS - X8.2-AHI (Topaz BL2) on $1$DGA3890:[SYS2.] sysboot 


PESOS - E8.2-ADH (Topaz BL1) on $1$DGA3891:[SYS2.] 


PESOS - E8.2-ADH (Topaz BL1) on $1$DGA3891:[SYS2.] sysboot 


Boot Option Maintenance Menu 
System Configuration Menu 


Select the "EFI Shell [Built-in]" 


Loading.: EFI Shell [Built-in] 
EFI Shell version 1.10 [14.61] 
Device mapping table 
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Example 11-2 (Cont.) Booting an 164 Target System 


fs0 : Acpi(HWP0002,100)/Pci(1|1)/Scsi(Pun0,Lun0)/HD(Part2, 
SigB3A4A931-1F2A-11D8-9EA1-AA000400FEFF) 

fsl : Acpi(HWP0002,100)/Pci(1|1)/Scsi(Pun2,Lun0)/HD(Part1l, 
SigF7B864C3) 


fs2 + Acpi(HWP0002,300)/Pci(1|0)/Fibre(WWN50001FE10011B15D, 
Lun2200) /HD(Part1,$ig51C7BEE1-070B-11D9-8099-AA000400FEFF) 

fs3 + Acpi(HWP0002,300)/Pci(1|0)/Fibre(WWN50001FE10011B15D, 
Lun2200) /HD(Part4, $ig51C7BEE0-070B-11D9-809A-AA000400FEFF) 


Shell> 


Select the desired device/partion: 


Shell> fs1l 
fsl:\> 


Use the utilities in \efi\vms. Use vms_show to list the devices and vms_set to 
set ethernet device (debug_dev), if necessary. Note that this set is sticky so it 
only needs to be done once. Then load the operating system with the desired 
flags. Note that Alpha and I64 use the same flags with the same meanings. 


fsl:\> dir \efi\vms 


Directory of: fs1:\efi\vms 


09/13/04 
09/13/04 
09/13/04 
09/13/04 
09/13/04 
09/13/04 
09/13/04 
09/13/04 
09/13/04 


5 
& 


10:13a <DIR> 
10:13a <DIR> 
10:13a <DIR> 
10:13a 
10:13a <DIR> 
10:13a 
10:13a 
10:13a 
10:13a 


2,048 
2,048 
2,048 

3,101,184 
2,048 

846,336 
244,224 
218,112 
215,040 


File(s) 4,624,896 bytes 


Dir(s) 


fsl:\> \efi\vms\vms_show device 


VMS: EIAO 


tools 

ipb.exe 

update 

vms loader.efi 
vms befg.efi 
vms set.efi 
vs show.efi 


EFI: Acpi(000222F0,0)/Pci(3|0)/Mac(00306E39F77B) 


VMS: DKB20 


0 


EFI: fsl: Acpi(000222F0,100)/Pci(1|1)/Scsi(Pun2,Lun0) 


VMS: DKBO 


EFI: fs0: Acpi(000222F0,100)/Pci(1|1)/Scsi(Pun0,Lun0) 


VMS: EWAO 


EFI: Acpi(000222F0,100)/Pci(2|0)/Mac(00306E3977C5) 


Set the debug_dev to one of the connected ethernet devices: 
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Example 11-2 (Cont.) Booting an 164 Target System 


fsl:\> \efi\vms\vms_set debug dev eia0 

VMS: EIAO 0-30-6E-39-F7-CF 

EFI: Acpi(000222F0,0)/Pci(3|0)/Mac(00306E39F7CF) 
fs1:\> \efi\vms\vms show debug dev 

VMS: EIAO ~  0=30-6E-39-F7-CF 

EFI: Acpi(000222F0,0)/Pci(3|0)/Mac(00306E39F7CF) 


Boot up the OS. In this example, the boot is with the SCD and initial (early) 
breakpoint flags, using root 2 (SYS2), that will vary with system setups: 


fs1:\> \efi\vms\vms_loader -flags "2,8004" 


hp OpenVMS Industry Standard 64 Operating System, Version XAHI-T32Z 
© Copyright 1976-2004 Hewlett-Packard Development Company, L.P. 


SEIA-I-BOOTDRIVER, Starting auto-negotiation 
SEIA-I-BOOTDRIVER, Auto-negotiation selected 100BaseTX FDX 


DBGTK: 
DBGTK: 


Initialization succeeded. Remote system debugging is now possible. 


Waiting at breakpoint for connection from remote host. 


The example continues by invoking the system code debugger’s character-cell 
interface on the host system. 


Example 11-3 Invoking the Alpha System Code Debugger 


$ define dbg$decw$display " " 
$ debug/keep 


OpenVMS Alpha Debug64 Version V8.2-014 


DBG> 


Example 11-4 Invoking the 164 System Code Debugger 


$ define dbg$decw$display " " 
$ debug/keep 


OpenVMS 164 Debug64 Version V8.2-014 


DBG> 


Use the CONNECT command to connect to the target system. In this example, 
the target system’s default password is the null string, and the logical name 
DBGHK$IMAGE_PATH is used for the image path; so the command qualifiers 
/PASSWORD and /IMAGE_PATH are not being used. You may need to use them. 


When you have connected to the target system, the DBG> prompt is displayed. 
Enter the SHOW IMAGE command to see what has been loaded. Because you 
are reaching a breakpoint early in the boot process, there are very few images. 
See Example 11-5. Notice that SYS$BASE_IMAGE has an asterisk next to it. 
This is the currently set image, and all symbols currently loaded in the debugger 
come from that image. 
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Example 11-5 Connecting to the Target System 


DBG> connect %node name TSTSYS 


%DEBUG-I-INIBRK, target system interrupted 
%DEBUG-I-DYNMODSET, setting module SYSTEM ROUTINES 


DBG> show image 
image name 


ERRORLOG 
NPROO 
NPRW1 
EXEC INIT 
*SYSSBASE IMAGE 
NPROO 
NPRW1 
SYSSCNBTDRIVER 
NPROO 
NPRW1 
SYSSCPU ROUTINES 0402 
NPROO ~ 
NPRW1 
SYSSESBTDRIVER 
NPROO 
NPRW1 
SYSSNISCA BTDRIVER 
NPROO — 
NPRW1 
SYSSOPDRIVER 
NPROO 
NPRW1 
SYSSPUBLIC VECTORS 
NPROO ~ 
NPRW1 
SYSTEM DEBUG 
SYSTEM PRIMITIVES MIN 
NPROO ~ 
NPRW1 
SYSTEM SYNCHRONIZATION UNI 
NPROO ~ 
NPRW1 


total images: 12 


set 


no 


no 
yes 


no 


no 


no 


no 


no 


no 


no 
no 


no 


bytes 
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base address 


0000000000000000 
FFFFFFFF80084000 
FFFFFFFF80CA3600 
FFFFFFFF8306E000 
0000000000000000 
FFFFFFFF80002000 
FFFFFFFF80C05C00 
0000000000000000 
FFFFFFFF8001A000 
FFFFFFFF80C2D600 
0000000000000000 
FFFFFFFF80010000 
FFFFFFFF80C2B000 
0000000000000000 
FFFFFFFF8002C000 
FFFFFFFF80C30C00 
0000000000000000 
FFFFFFFF8001C000 
FFFFFFFF80C2DA00 
0000000000000000 
FFFFFFFF80030000 
FFFFFFFF80C31000 
0000000000000000 
FFFFFFFF80000000 
FFFFFFFF80C00000 
FFFFFFFF82FFE000 
0000000000000000 
FFFFFFFF80034000 
FFFFFFFF80C31A00 
0000000000000000 
FFFFFFFF80078000 
FFFFFFFF80CA1200 


allocated: 1517736 


end address 


FFFFFFFFFFFFFFFFE 
FFFFFFFF80086FFF 
FFFFFFFF80CA3BFF 
FFFFFFFF830A2000 
PFFFFFFFFFFFFFFF 
FFFFFFFF8000EDFF 
FFFFFFFF80C2AFFF 
FFFFFFFFFFFFFFFFE 
FFFFFFFF8001AFFF 
FFFFFFFF80C2D9FF 
PFFFFFFFFFFFFFFF 
FFFFFFFF800191FF 
FFFFFFFF80C2D5FF 
FFFFFFFFFFFFFFFFE 
FFFFFFFF8002E1FF 
FFFFFFFF80C30FFF 
FFFFFFFFFFFFFFFE 
FFFFFFFF8002ADFF 
FFFFFFFF80C30BFF 
FFFFFFFFFFFFFFFFE 
FFFFFFFF800337FF 
FFFFFFFF80C319FF 
FFFFFFFFFFFFFFFFE 
FFFFFFFF80001FFF 
FFFFFFFF80C05BFF 
FFFFFFFF83056000 
FFFFFFFFFFFFFFFF 
FFFFFFFF800775FF 
FFFFFFFF80CA11FF 
FFFFFFFFFFFFFFFFE 
FFFFFFFF800835FF 
FFFFFFFF80CA35FF 
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Example 11-6 shows the target system’s console display during the connect 
sequence. Note that for security reasons, the name of the host system, the user’s 
name, and process ID are displayed. 


Example 11-6 Target System Connection Display 


DBGTK: Connection attempt from host HSTSYS user GUEST process 2E801C2F 
DBGTK: Connection attempt succeeded 


To set a breakpoint at the first routine in the CTEST_ROUTINES module of the 
SYSTEM_DEBUG.EXE execlet, do the following: 


1. Load the symbols for the SYSTEM_DEBUG image with the DEBUG SET 
IMAGE command. 


2. Use the SET MODULE command to obtain the symbols for the module. 
3. Set the language to be C and set a breakpoint at the routine test_c_code. 


The language must be set because C is case sensitive and test_c_code needs 

to be specified in lowercase. The language is normally set to the language of 
the main image, in this example SYS$BASE_IMAGE.EXE. Currently that is 
not C. 


Example 11-7 Setting a Breakpoint 


DBG> set image system debug 
DBG> show module 


module name symbols language size 
AUX TARGET no Cc 15928 
BUFSRV TARGET no C 11288 
BUGCHECK CODES no BLISS 26064 
CRTLPRINTF no Cc 29920 
C TEST ROUTINES no Cc 3808 
FATAL EXC no Cc 1592 
HIGH ADDRESS no Cc 372 
LIBSCALLING STANDARD AUX no MACRO64 1680 
LINMGR TARGET ~ no Cc 13320 
LOW ADDRESS no Cc 368 
OBJMGR no Cc 5040 
PLUMGR no Cc 19796 
POOL no iC 116 
PROTOMGR TARGET no Cc 17868 
SOCMGR ~ no Cc 3324 
SYSSDOINIT no AMACRO 81740 
TARGET KERNEL no Cc 207244 
TMRMGR TARGET no C 3516 
XDELTA no BLISS 189940 
XDELTA_ISRS no MACRO64 2428 
total modules: 20. bytes allocated: 1585168. 
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Example 11-7 (Cont.) Setting a Breakpoint 


DBG> set module c_test routines 
DBG> show module c test _routines 
module name 


C_TEST_ ROUTINES 


total C modules: 1. 
DBG> set language c 
DBG> show symbol test c code* 
routine C TEST ROUTINES\test c code5 
routine C TEST ROUTINES\test c code4 
routine C TEST ROUTINES\test c code3 
routine C TEST ROUTINES\test c code2 
routine C TEST " ROUTINES \test Cc "code 
DBG> set break - test_c_code 


size 


3808 


symbols 


yes 


bytes allocated: 


1592264. 


Now that the breakpoint is set, you can proceed and activate the breakpoint. 
When that occurs, the debugger tries to open the source code for that location in 
the same place as where the module was compiled. Because that is not the same 
place as on your system, you need to tell the debugger where to find the source 
code. This is done with the debugger’s SET SOURCE command, which takes a 
search list as a parameter so you can make it point to many places. 


Example 11-8 Finding the Source Code 


DBG> set source/latest sys$examples,sys$library 

DBG> go 

break at pag C_TEST ROUTINES\test_c_code 
166: = xdt$fregsav[0]; 
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Now that the debugger has access to the source, you can put the debugger into 
screen mode to see exactly where you are and the code surrounding it. 


Example 11-9 Using the Set Mode Screen Command 


DBG> Set Mode Screen; Set Step Nosource 


- SRC: module C_TEST ROUTINES -scroll-source------------------------------------ 


151: xdtS$fregsav[5] = in64; 
152: xdt$fregsav[6] = in32; 
153: if (xdt$fregsav[9] > 0) 
154: *pVar = (*pVar + xdt$fregsav[17])%xdt$fregsav[9]; 
1553 else 
156: *pVar = (*pVar + xdt$fregsav[17]); 
157: xdt$fregsav[7] = test c code3(10); 
158: xdt$fregsav[3] = test; _ 
159: return xdt$fregsav[23]; 
160: } 
161: void test c code(void) 
162: { — 
163: int x,y; 
164: int64 x64,y64; 
165: 

-> 166: x = xdt$fregsav[0]; 
167: y = xdtSfregsav[1]; 
168: x64 = xdt$fregsav[2]; 
169: y64 = xdt$fregsav[3]; 
170: xdt$fregsav[14] = test_c_code2(x64+y64,xty,x64+x, &y64); 
17 is test c code4(); 
172: return; 
173: } 

- OUT -output--------------------------- == --- 5-5 5 ne en en ne enn eee 


- PROMPT -error-program-prompt-------------------------------------------------- 


DBG> 
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Now, you want to set another breakpoint inside the test_c_code3 routine. You 
use the debugger’s SCROLL/UP command (8 on the keypad) to move to that 
routine and see that line 146 would be a good place to set the breakpoint. It is at 
a recursive call. Then you proceed to that breakpoint with the GO command. 


Example 11-10 Using the SCROLL/UP DEBUG Command 


- SRC: module C_TEST ROUTINES -scroll-source------------------------------------ 
133: void test_c_code4(void) 


134: { 
135: int i,k; 
136: for (k=0;k<1000;k++) 
137; { 
138: test_c_code5(&i); 
139: 
140: return; 
141: } 
142: int test_c_code3(int subrtnCount) 
143: { 
144; subrtnCount = subrtnCount - 1; 
145: if (subrtnCount != 0) 
146: subrtnCount = test c code3(subrtnCount) ; 
147: return subrtnCount;  — 
148: } 
149: int test_c_code2(int64 in64,int in32, int64 test, int64* pVar) 
150: { 
151: xdt$fregsav[5] = in64; 
152: xdtS$fregsav[6] = in32; 
153: if (xdt$fregsav[9] > 0) 
154: *pVar = (*pVar + xdt$fregsav[17])%xdt$fregsav[9]; 
155: else 
- OUT -output------------------------------ = -- 5-5 5 5 oo ee nn ee ee 


- PROMPT -error-program-prompt-------------------------------------------- === == 


DBG> Scroll/Up 

DBG> set break %line 146 
DBG> go 

DBG> 
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When you reach that breakpoint, the source code display is updated to show 
where you currently are, which is indicated by an arrow. A message also appears 
in the OUT display indicating you reach the breakpoint at that line. 


Example 11-11 Breakpoint Display 


- SRC: module C TEST ROUTINES -scroll-source------------------------------------ 
135: int i,k; 
136: for (k=0;k<1000;k++) 
137: { 
138: test_c_code5(&i); 
139: } 
140: return; 
141: } 
142: int test_c_code3(int subrtnCount) 
143: { 
144: subrtnCount = subrtnCount - 1; 
145: if (subrtnCount != 0) 
-> 146: subrtnCount = test c code3(subrtnCount) ; 
147: return subrtnCount;  — 
148: } 
149: int test_c code2(int64 in64,int in32, int64 test, int64* pVar) 
150: { 
151: xdt$fregsav[5] = in64; 
152: xdt$fregsav[6] = in32; 
153: if (xdt$fregsav[9] > 0) 
154: *pVar = (*pVar + xdtS$fregsav[17])%xdt$fregsav[9]; 
155: else 
156: *pVar = (*pVar + xdt$fregsav[17]); 
157: xdt$fregsav[7] = test c code3(10); 
- OUT -output-------------------- Jee nena n----- +--+ +--+ +--+ ee 


break at C_TEST ROUTINES\test_c_code3\%LINE 146 


- PROMPT -error-program-prompt-------------------------------------------------- 


DBG> Scroll/Up 
DBG> set break %line 146 


DBG> go 


DBG> 
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Now you try the debugger’s STEP command. The default behavior for STEP is 
STEP/OVER, unlike XDELTA and DELTA, which is STEP/INTO, so, normally 
you would expect to step to line 147 in the code. However, because you have a 
breakpoint inside test_c_code3 that is called at line 146, you will reach that event 
first. 


Example 11-12 Using the Debug Step Command 


- SRC: module C_TEST ROUTINES -scroll-source------------------------------------ 


135: int i,k; 
136: for (k=0;k<1000;k++) 
137: { 
138: test_c_code5(&i); 
139: } 
140: return; 
141: } 
142: int test_c_code3(int subrtnCount) 
143: { 
144; subrtnCount = subrtnCount - 1; 
145: if (subrtnCount != 0) 
-> 146: subrtnCount = test c code3(subrtnCount) ; 
147: return subrtnCount; — 
148: } 
149: int test_c_code2(int64 in64,int in32, int64 test, int64* pVar) 
150: { 
Tas xdt$fregsav[5] = in64; 
152: xdt$fregsav[6] = in32; 
153: if (xdt$fregsav[9] > 0) 
154: *pVar = (*pVar + xdt$fregsav[17])%xdt$fregsav[9]; 
155: else 
156: *pVar = (*pVar + xdt$fregsav[17]); 
157: xdt$fregsav[7] = test c code3(10); 
- OUT -output-------------------- pee enn nnn nn nnn 5-5-5 === === 


break at C_TEST ROUTINES\test_c_code3\%LINE 146 
break at C_TEST ROUTINES\test_c_code3\%LINE 146 


- PROMPT -error-program-prompt----------- nn nnn nnn nen n nn nnn nnnn 


DBG> 


DBG> set break %line 146 


DBG> go 
DBG> Step 
DBG> 
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Now, you try a couple of other commands, EXAMINE and SHOW CALLS. The 
EXAMINE command allows you to look at all the C variables. Note that the 
C_TEST_ROUTINES module is compiled with the /NOOPTIMIZE switch which 
allows access to all variables. The SHOW CALLS command shows you the call 
sequence from the beginning of the stack. In this case, you started out in the 
image EXEC_INIT. (The debugger prefixes all images other than the main image 
with SHARE$ so it shows up as SHARE$EXEC_INIT.) 


Example 11-13 Using the Examine and Show Calls Commands 


- SRC: module C_TEST ROUTINES -scroll-source------------------------------------ 


135: int i,k; 
136: for (k=0;k<1000;k++) 
137: { 
138: test c code5(&i); 
139: } _ 
140: return; 
141: } 
142: int test_c_code3(int subrtnCount) 
143: { 
144: subrtnCount = subrtnCount - 1; 
145: if (subrtnCount != 0) 
-> 146: subrtnCount = test c code3(subrtnCount) ; 
147: return subrtnCount; ~ 
148: } 
149: int test_c_code2(int64 in64,int in32, int64 test, int64* pVar) 
150: { 
151: xdt$fregsav[5] = in64; 
152: xdt$fregsav[6] = in32; 
153: if (xdt$fregsav[9] > 0) 
154: *pVar = (*pVar + xdt$fregsav[17])%xdt$fregsav[9]; 
155: else 
156: *pVar = (*pVar + xdt$fregsav[17]); 
157: xdt$fregsav[7] = test c code3(10); 
- OUT -output-------------------- eee nnn nnn nnn nnn nnn nnn nnn eee === 


break at C_TEST ROUTINES\test_c_code3\%LINE 146 
break at C TEST ROUTINES\test c code3\%LINE 146 


C_TEST ROUTINES\test_c_code3\subrtnCount: 8 

module name routine name line rel PC abs PC 
*C_TEST ROUTINES test_c_code3 146 00000000000000C4 FFFFFFFF83002D64 
*C_TEST ROUTINES test _c_code3 146 00000000000000D4 FFFFFFFF83002D74 
*C_TEST ROUTINES test_c_code2 157 00000000000001A0 FFFFFFFF83002E40 
*C_TEST ROUTINES test _c code 170 0000000000000260 FFFFFFFF83002F00 
*XDELTA | XDTSSYSDBG_INIT 9371 0000000000000058 FFFFFFFF83052238 
*SYSSDOINIT INISDOINIT 1488 0000000000000098 FFFFFFFF830520B8 
SHARESEXEC_INIT 0000000000018C74 FFFFFFFF83086C74 
SHARESEXEC_INIT 0000000000014BD0 FFFFFFFF83082BD0 


- PROMPT -error-program-prompt-------------------------------------------------- 
DBG> 

DBG> set break %line 146 

DBG> go 

DBG> Step 

DBG> examine subrtnCount 

DBG> show calls 

DBG> 
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If you want to proceed because you are done debugging this code, first cancel 
all the breakpoints and then enter the GO command. Notice, however, that you 
do not keep running but receive a message that you have stepped to line 147. 
This happens because the STEP command used earlier never completed. It was 
interrupted by the breakpoint on line 146. 


Note that the debugger remembers all step events and only removes them once 
they have completed. 


Example 11-14 Canceling the Breakpoints 


- SRC: module C TEST ROUTINES -scroll-source------------------------------------ 


136: for(k=0;k<1000;k++) 
137: { 
138: test_c_code5(&i); 
139: } 
140: return; 
141: } 
142: int test_c_code3(int subrtnCount) 
143: { 
144; subrtnCount = subrtnCount - 1; 
145: if (subrtnCount != 0) 
146: subrtnCount = test c code3(subrtnCount) ; 
-> 147: return subrtnCount; — 
148: } 
149: int test_c_code2(int64 in64,int in32, int64 test, int64* pVar) 
150: { 
151: xdt$fregsav[5] = in64; 
152% xdt$fregsav[6] = in32; 
153: if (xdt$fregsav[9] > 0) 
154: *pVar = (*pVar + xdt$fregsav[17])%xdt$fregsav[9]; 
155: else 
156: *pVar = (*pVar + xdt$fregsav[17]); 
157: xdt$fregsav[7] = test c code3(10); 
158: xdt$fregsav[3] = test; 
- OUT -output--------------------------------- 5-5 5 5 5 oo oe ee en ee eee 


break at C_TEST ROUTINES\test_c_code3\%LINE 146 
break at C TEST ROUTINES\test c code3\%LINE 146 


C TEST ROUTINES\test c code3\subrtnCount: 8 
module name routine name line rel PC abs PC 
*C TEST ROUTINES test c code3 146 00000000000000C4 FFFFFFFF83002D64 
*C TEST ROUTINES test c code3 146 00000000000000D4 FFFFFFFF83002D74 
*C TEST ROUTINES test c code2 157 00000000000001A0 FFFFFFFF83002E40 
*C TEST ROUTINES test c code 170 0000000000000260 FFFFFFFF83002F00 
*XDELTA _ XDTSSYSDBG INIT 9371 0000000000000058 FFFFFFFF83052238 
*SYSSDOINIT INISDOINIT 1488 0000000000000098 FFFFFFFF830520B8 
SHARESEXEC INIT 0000000000018C74 FFFFFFFF83086C74 
SHARESEXEC INIT 0000000000014BD0 FFFFFFFF83082BD0 


stepped to C_TEST ROUTINES\test_c_code3\%LINE 147 


- PROMPT -error-program-prompt-------------------------------------------------- 
DBG> go 

DBG> Step 

DBG> examine subrtnCount 

DBG> show calls 

DBG> cancel break/all 

DBG> go 

DBG> 
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The STEP/RETURN command, a different type of step command, single steps 
assembly code until it finds a return instruction. This command is useful if you 
want to see the return value for the routine, which is done here by examining the 
RO register. 


For more information about using other STEP command qualifiers, see the HP 
OpenVMS Debugger Manual. 


Example 11-15 Using the Step/Return Command 


- SRC: module C_TEST ROUTINES -scroll-source------------------------------------ 


137: { 
138: test_c_code5(&1); 
139: } 
140: return; 
141: } 
142: int test_c_code3(int subrtnCount) 
143: { 
144; subrtnCount = subrtnCount - 1; 
145: if (subrtnCount != 0) 
146: subrtnCount = test c code3(subrtnCount) ; 
147: return subrtnCount; ~ 

-> 148: } 
149: int test_c_code2(int64 in64,int in32, int64 test, int64* pVar) 
150: { 
151s xdt$fregsav[5] = in64; 
152: xdt$fregsav[6] = in32; 
153 if (xdt$fregsav[9] > 0) 
154: *pvVar = (*pVar + xdt$fregsav[17])%xdt$fregsav[9]; 
155: else 
156: *pVar = (*pVar + xdt$fregsav[17]); 
157: xdt$fregsav[7] = test c code3(10); 
158: xdt$fregsav[3] = test} 
159: return xdt$fregsav[23]; 

- OUT -OUtpUt---------- 3-9 nn nn nnn nn nnn nnn nn nnn nn nnn nnn nnn nn nnn nnn nnn ane 


break at C_TEST ROUTINES\test_c code3\%LINE 146 
break at C TEST ROUTINES\test c code3\%LINE 146 


C TEST ROUTINES\test c code3\subrtnCount: 8 

module name routine name line rel PC abs PC 

*C TEST ROUTINES test c code3 146 00000000000000C4 FFFFFFFF83002D64 
*C TEST ROUTINES test c code3 146 00000000000000D4 FFFFFFFF83002D74 
*C_TEST ROUTINES test_c_code2 157 00000000000001A0 FFFFFFFF83002E40 
*C TEST ROUTINES test c code 170 0000000000000260 FFFFFFFF83002F00 
*XDELTA XDTS$SYSDBG_INIT 9371 0000000000000058 FFFFFFFF83052238 
*SYSSDOINIT INISDOINIT 1488 0000000000000098 FFFFFFFF830520B8 
SHARESEXEC INIT 0000000000018C74 FFFFFFFF83086C74 
SHARESEXEC_INIT 0000000000014BD0 FFFFFFFF83082BD0 


stepped to C TEST ROUTINES\test c code3\%LINE 147 

stepped on return from C TEST ROUTINES\test c code3\%LINE 147 to C TEST ROUTINES\test c code3\%LINE 148 
C_TEST ROUTINES\test_c_code3\%R0: 0 7 7 a 
- PROMPT -error-prograMm-prompt ------------ $< - nn nnn nnn nnn nnn = 

DBG> examine subrtnCount 

DBG> show calls 

DBG> cancel break/all 

DBG> go 

DBG> step/return 

DBG> examine r0 

DBG> 
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After you finish the SCD session, enter the GO command to leave this module. 
You will encounter another INI$BRK breakpoint at the end of EXEC_INIT. 

An error message indicating there are no source lines for address 80002010 is 
displayed, because debug information on this image or module is not available. 


Also notice that there is no message in the OUT display for this event. That 
is because INI$BRKs are special breakpoints that are handled as SS$_DEBUG 
signals. They are a method for the system code to break into the debugger and 
there is no real breakpoint in the code. 


Example 11-16 Source Lines Error Message 


- SRC: module SYSTEM ROUTINES -scroll-source------------------------------------ 


15896: 
15897: 


Source line not available 
Source line not available 


15906: 
->5907: 
15908: 


15917: 
15918: 


- OUT -output 


Source line not 
Source line not 
Source line not 


Source line not 
Source line not 


available 
available 
available 


available 
available 


break at C_TEST ROUTINES\test_c_code3\%LINE 146 
break at C TEST ROUTINES\test c code3\%LINE 146 


C_TEST ROUTINES\test_c_code3\subrtnCount: 


module name 

*C TEST ROUTINES 
*C TEST ROUTINES 
*C_TEST ROUTINES 
*C TEST ROUTINES 
*XDELTA 
*SYSSDOINIT 
SHARESEXEC INIT 
SHARESEXEC INIT 


8 
routine name line rel PC abs PC 
test c code3 146 00000000000000C4 FFFFFFFF83002D64 
test c code3 146 00000000000000D4 FFFFFFFF83002D74 
test_c_code2 157 00000000000001A0 FFFFFFFF83002E40 
test_c_code 170 0000000000000260 FFFFFFFF83002F00 
XDT$SYSDBG INIT 9371 0000000000000058 FFFFFFFF83052238 
INISDOINIT 1488 0000000000000098 FFFFFFFF830520B8 
0000000000018C74 FFFFFFFF83086C74 
0000000000014BD0 FFFFFFFF83082BD0 


stepped to C TEST ROUTINES\test c code3\SLINE 147 

stepped on return from C TEST ROUTINES\test c code3\$LINE 147 to C TEST ROUTINES\test c code3\SLINE 148 
C_TEST ROUTINES\test_c_code3\%R0: 0 7 7 7 — 

- PROMPT -error-prograMm-prompt-------------- 2 nn nn nn nn nnn nnn nn nnn nnn nnn 


DBG> examine r0 
DBG> go 
SDEBUG-I-INIBRK, 


target system interrupted 


%DEBUG-I-DYNIMGSET, setting image SYSSBASE IMAGE 
%DEBUG-W-SCRUNAOPNSRC, unable to open source file SYSSCOMMON: [SYSLIB]SYSTEM ROUTINES .M64; 


-RMS-E-FNF, file 
DBG> 


not found 
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Enter the SHOW IMAGE command. You will see more images displayed as the 
boot path has progressed further. 


Finally, enter GO, allowing the target system to boot completely, because there 
are no more breakpoints in the boot path. The debugger will wait for another 
event to occur. 


Example 11-17 Using the Show Image Command 


- SRC: module SYSTEM ROUTINES -scroll-source------------------------------------ 
15896: Source line not available 
15897: Source line not available 


15906: Source line not available 
->5907: Source line not available 
15908: Source line not available 


15917: Source line not available 
15918: Source line not available 


- OUT -output---------------------------- = --- 5-5-5 on eo nn ne eee eee 
PRO2 FFFFFFFF8329C000 FFFFFFFF832A2DFF 
SYSLICENSE no 0000000000000000 FFFFFFFFFFFFFFFF 
NPROO FFFFFFFF 80188000 FFFFFFFF801883FF 
NPRW1 FFFFFFFF80CCC000 FFFFFFFF80CCC5FF 
PRO2 FFFFFFFF8321E000 FFFFFFFF832247FF 
PRW3 FFFFFFFF83226000 FFFFFFFF832265FF 
SYSTEM DEBUG yes FFFFFFFF82FFE000 FFFFFFFF 83056000 
SYSTEM PRIMITIVES MIN no 0000000000000000 FFFFFFFFFFFFFFFF 
NPROO ~ FFFFFFFF 80034000 FFFFFFFF800775FF 
NPRW1 FFFFFFFF80C31A00 FFFFFFFF80CAL11FF 
SYSTEM SYNCHRONIZATION UNI no 0000000000000000 FFFFFFFFFFFFFFFE 
NPROO - FFFFFFFF 80078000 FFFFFFFF800835FF 
NPRW1 FFFFFFFF80CA1200 FFFFFFFF80CA35FF 


total images: 40 


- PROMPT -error-program-prompt 


bytes allocated: 2803296 


SDEBUG-I-INIBRK, target system interrupted 
SDEBUG-I-DYNIMGSET, setting image SYSSBASE IMAGE 


%DEBUG-W-SCRUNAOPNSRC, unable to open source file X6P3_RESD$:[SYSLIB]SYSTEM ROUTINES.M64; 


-RMS-E-FNF, file not found 


DBG> show image 
DBG> go 


OpenVMS System Code Debugger 11-29 


12 


OpenVMS Alpha System Dump Debugger 


This chapter describes the OpenVMS Alpha System Dump Debugger (SDD) and 
how you can use it to analyze system crash dumps. 


Alpha Only 


This utility runs on OpenVMS Alpha systems only. 


SDD is similar in concept to SCD as described in Chapter 11. Where SCD allows 
connection to a running system with control of the system’s execution and the 
examination and modification of variables, SDD allows analysis of memory as 
recorded in a system dump. 


Use of the SDD usually involves two systems, although all the required 
environment can be set up on a single system. The description that follows 
assumes that two systems are being used: 


e The build system, where the image that causes the system crash has been 
built 


e The test system, where the image is executed and the system crash occurs 


In common with SCD, the OpenVMS debugger’s user interface allows you to 
specify variable names, routine names, and so on, precisely as they appear in 
your source code. Also, SDD can display the source code where the software was 
executing at the time of the system crash. 


SDD recognizes the syntax, data typing, operators, expressions, scoping rules, 
and other constructs of a given language. If your code or driver is written in more 
than one language, you can change the debugging context from one language to 
another during a debugging session. 


To use SDD, you must do the following: 
e Build the system image or device driver that is causing the system crash. 


e Boot a system, including the system image or device driver, and perform the 
necessary steps to cause the system crash. 


e Reboot the system and save the dump file. 
e Invoke SDD, which is integrated with the OpenVMS debugger. 


The following sections cover these tasks in more detail, describe the available 
user-interface options, summarize applicable OpenVMS Debugger commands, and 
provide a sample SDD session. 
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12.1 User-Interface Options 
SDD has the following user-interface options. 


e A DECwindows Motif interface for workstations. 


When using this interface, you interact with SDD by using a mouse and 
pointer to choose items from menus, click on buttons, select names in 
windows, and so on. 


Note that you can also use OpenVMS Debugger commands with the 
DECwindows Motif interface. 
e Acharacter cell interface for terminals and workstations. 


When using this interface, you interact with SDD by entering commands at 
a prompt. The sections in this chapter describe how to use the system dump 
debugger with the character cell interface. 


For more information about using the OpenVMS DECwindows Motif interface 
and OpenVMS Debugger commands with SDD, see the HP OpenVMS 
Debugger Manual. 


12.2 Preparing a System Dump to Be Analyzed 
To prepare a system dump for analysis, perform the following steps: 
1. Compile the sources you will want to analyze, and use the /DEBUG 
(mandatory) and /NOOPT (preferred) qualifiers. 
Note 


Because you are analyzing a snapshot of the system, it is not as vital 
to use unoptimized code as it is with the system code debugger. But 
note that you cannot access all variables. SDD may report that they are 
optimized away. 


2. Link your image using the /DSF (debug symbol file) qualifier. Do not use the 
/DEBUG qualifier, which is for debugging user programs. The /DSF qualifier 
takes an optional filename argument similar to the /EXE qualifier. For more 
information, see the HP OpenVMS Linker Utility Manual. If you specify a 
name in the /EXE qualifier, you will need to specify the same name for the 
/DSF qualifier. For example, you would use the following command: 


$ LINK/EXE=EXE$ :MY_EXECLET/DSF=EXE$ :MY_EXECLET OPTIONS FILE/OPT 


The .DSF and .EXE file names must be the same. Only the extensions will be 
different, that is, .DSF and .EXE. 


The contents of the .EXE file should be exactly the same as if you had linked 
without the /DSF qualifier. The .DSF file will contain the image header and 
all the debug symbol tables for .EXE file. It is not an executable file, and 
cannot be run or loaded. 


Put the .EXE file on your test system. 


4. Boot the test system and perform the necessary steps to cause the system 
crash. 


5. Reboot the test system and copy the dump to the build system using the 
System Dump Analyzer (SDA) command COPY. See Chapter 4. 
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12.3 Setting Up the Test System 


The only requirement for the test system is that the .DSF file matching the .EXE 
file that causes the crash is available on the build system. 


There are no other steps necessary in the setup of the test system. With the 
system image copied to the test system, it can be booted in any way necessary 
to produce the system crash. Since SDD can analyze most system crash dumps, 
any system can be used, from a standalone system to a member of a production 
cluster. 


Note 


It is assumed that the test system has a dump file large enough for 

the system dump to be recorded. Any dump style may be used (full or 
selective, compressed or uncompressed). A properly AUTOGENed system 
will meet these requirements. 


12.4 Setting Up the Build System 


To set up the build system, you need access to all system images and drivers that 
were loaded on the test system. You should have access to a source listings kit or 
a copy of the following directories: 


SYSSLOADABLE IMAGES: 
SYSSLIBRARY: 
SYSSMESSAGE: 


You need all the .EXE files in those directories. The .DSF files are available with 
the OpenVMS Alpha source listings kit. 


Optionally, you need access to the source files for the images to be debugged. 
SDD will look for the source files in the directory where they were compiled. You 
must use the SET SOURCE command to point SDD to the location of the source 
code files if they are not in the directories used when the image was built. For an 
example of the SET SOURCE command, see Section 12.9. 


Before you can analyze a system dump with SDD, you must set up the logical 
name DBGHK$IMAGE_PATH, which must be set up as a search list to the area 
where the system images or .DSF files are kept. For example, if the copies are in 
the following directories: 

DEVICE: [SYS$LDR] 


DEVICE: [ SYSLIB ] 
DEVICE: [ SYSMSG ] 


you would define DBGHK$IMAGE_PATH as follows: 
$ define dbghk$image path DEVICE: [SYS$LDR] , DEVICE: [SYSLIB] , DEVICE: [ SYSMSG] 


This works well for analyzing a system dump using all the images normally 
loaded on a given system. However, you might be using SDD to analyze new code 
either in an execlet or a new driver. Because that image is most likely in your 
default directory, you must define the logical name as follows: 


$ define dbghk$image path [],DEVICE:[SYS$LDR] , DEVICE: [SYSLIB] , DEVICE: [SYSMSG] 
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If SDD cannot find one of the images through this search path, a warning 
message is displayed. SDD will continue initialization as long as it finds at 
least one image. If SDD cannot find the SYS$BASE_IMAGE file, which is 
the OpenVMS Alpha operating system’s main image file, an error message is 
displayed and the debugger exits. 


If and when this happens, check the directory for the image files and compare it 
to what was loaded on the test system. 


12.5 Starting the System Dump Debugger 
To start SDD on the build system, enter the following command. 
$ DEBUG/KEEP 


SDD displays the DBG> prompt. With the DBGHK$IMAGE_PATH logical name 
defined, you can invoke the ANALYZE/CRASH_DUMP command and optional 
qualifier /IMAGE_PATH. 


To use the ANALYZE/CRASH_DUMP command and optional qualifier /IMAGE_ 
PATH) to analyze the dump in file <file-name> enter the following command: 


DBG> ANALYZE/CRASH_DUMP file-name 


The /IMAGE_PATH qualifier is optional. If you do not use this qualifier, SDD 
uses the DBGHK$IMAGE_PATH logical name as the default. The /IMAGE_PATH 
qualifier is a quick way to change the logical name. However, when you use it, 
you cannot specify a search list. You can use only a logical name or a device and 
directory, although the logical name can be a search list. 


Usually, SDD obtains the source file name from the object file. This is put there 
by the compiler when the source is compiled with the /DEBUG qualifier. The SET 
SOURCE command can take a list of paths as a parameter. It treats them as a 
search list. 


12.6 Summary of System Dump Debugger Commands 


Only a subset of OpenVMS debugger commands can be used in SDD. The 
following are a few examples of commands that you can use in SDD: 


e Commands to manipulate the source display, such as TYPE and SCROLL 


e Commands used in OpenVMS debugger command programs, such as DO and 
IF 


e Commands that affect output formats, such as SET RADIX 


e Commands that manipulate symbols and scope, such as EVALUATE, SET 
LANGUAGE, and CANCEL SCOPE 


e Commands that read the contents of memory and registers, such as 
EXAMINE 


Examples of commands that cannot be used in SDD are as follows: 
¢ Commands that cause code to be executed, such as STEP and GO 


e Commands that manipulate breakpoints, such as SET BREAK and CANCEL 
BREAK 


e Commands that modify memory or registers, such as DEPOSIT 
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You can also use the OpenVMS debugger command SDA to examine the system 
dump with System Dump Analyzer semantics. This command, which is not 
available when debugging user programs, is described in the next section. 


12.7 Using System Dump Analyzer Commands 


Once a dump file has been opened, you can use the commands listed in the 
previous section to examine the system dump. You can also use some System 
Dump Analyzer (SDA) commands, such as SHOW SUMMARY and SHOW 
DEVICE. This feature allows the system programmer to take advantage of the 
strengths of both the OpenVMS Debugger and SDA to examine the system dump 
and to debug system programs such as device drivers, without having to invoke 
both the OpenVMS debugger and SDA separately. 


To obtain access to SDA commands, you simply type "SDA" at the OpenVMS 
Debugger prompt ("DBG>") at any time after the dump file has been opened. 
SDA initializes itself and then outputs the "SDA>" prompt. Enter SDA commands 
as required. (See Chapter 4 for more information.) To return to the OpenVMS 
Debugger, you enter "EXIT" at the "SDA>" prompt. Optionally, you may invoke 
SDA to perform a single command and then return immediately to the OpenVMS 
Debugger, as in the following example: 


DBG> SDA SHOW SUMMARY 


SDA may be reentered at any time, with or without the optional SDA command. 
Once SDA has been initialized, the SDA> prompt is output more quickly on 
subsequent occasions. 


Note that there are some limitations on the use of SDA from within SDD: 


e You cannot switch between processes, whether requested explicitly (SET 
PROCESS <name>) or implicitly (SHOW PROCESS <name>). The exception 
to this is that access to the system process is possible. 


e You cannot switch between CPUs. 


e SDA has no knowledge of the OpenVMS debugger’s Motif or Windows 
interfaces. Therefore, all SDA input and output occurs at the terminal or 
window where the OpenVMS debugger was originally invoked. Also, while 
using SDA, the OpenVMS debugger window is not refreshed; you must exit 
SDA to allow the OpenVMS debugger window to be refreshed. 


e When you invoke SDA from SDD with an immediate command, and that 
command produces a full screen of output, SDA displays the message "Press 
RETURN for more." followed by the "SDA>" prompt before continuing. At 
this prompt, if you enter another SDA command, SDA does not automatically 
return to SDD upon completion. To do this, you must enter an EXIT 
command. 


If the need arises to switch between processes or CPUs in the system dump, then 
you must invoke SDA separately using the DCL command ANALYZE/CRASH_ 
DUMP. 
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12.8 Limitations of the System Dump Debugger 


SDD provides a narrow window into the context of the system that was current 
at the time that the system crashed (stack, process, CPU, and so on). It does not 
provide full access to every part of the system as is provided by SDA. However, 
it does provide a view of the failed system using the semantics of the OpenVMS 
debugger—source correlation and display, call frame traversal, examination of 
variables by name, language constructs, and so on. 


SDD therefore provides an additional approach to analyzing system dumps that is 
difficult to realize with SDA, often allowing quicker resolution of system crashes 
than is possible with SDA alone. When SDD cannot provide the needed data from 
the system dump, you should use SDA instead. 


12.9 Access to Symbols in OpenVMS Executive Images 


For a discussion and explanation of how the OpenVMS debugger accesses symbols 
in OpenVMS executive images, see Section 11.11. 


12.10 Sample System Dump Debugging Session 


This section provides a sample session that shows the use of some OpenVMS 
debugger commands as they apply to the system dump debugger. The examples 
in this section show how to work with a dump created as follows: 


1. Follow the steps in Section 11.12, up to and including Example 8-9 
(Breakpoint Display). 


2. When the breakpoint at line 146 is reached, enter the OpenVMS debugger 
command to clear R27 and then continue: 


DBG> DEPOSIT R27=0 
DBG> GO 


3. The system then crashes and a dump is written. 


4. When the system reboots, copy the contents of 
SYS$SYSTEM:SYSDUMP.DMP to the build system with SDA: 


$ analyze/crash sysS$system:sysdump.dmp 


OpenVMS (TM) Alpha system dump analyzer 
...analyzing a selective memory dump... 


%SDA-W-NOTSAVED, global pages not saved in the dump file 
Dump taken on 1-JAN-1998 00:00:00.00 
INVEXCEPTN, Exception while above ASTDEL 


SDA> copy hstsys::sysdump.dmp 
SDA> 


To reproduce this sample session, you need access to the SYSTEM_DEBUG.DSF 
matching the SYSTEM_DEBUG.EXE file on your test system and to the source 
file C'TEST_ROUTINES.C, which is available in SYS$SEXAMPLES. 
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The example begins by invoking the system dump debugger’s character cell 
interface on the build system. 


Example 12-1 Invoking the System Dump Debugger 


$ define dbg$decw$display " " 
$ debug/keep 


OpenVMS Alpha Debug64 Version V7.2-019 


DBG> 


Use the ANALYZE/CRASH_DUMP command to open the system dump. In this 
example, the logical name DBGHK$IMAGE_PATH is used for the image path, so 
the command qualifier /IMAGE_PATH is not being used. You may need to use it. 


When you have opened the dump file, the DBG> prompt is displayed. You should 
now do the following: 


1. Set the language to be C, the language of the module that was active at the 
time of the system crash. 


2. Set the source directory to the location of the source of the module. Use the 
debugger’s SET SOURCE command, which takes a search list as a parameter 
so you can make it point to many places. 


Example 12-2 Accessing the System Dump 


DBG> analyze/crash dump sysdump.dmp 

%SDA-W-NOTSAVED, global pages not saved in the dump file 
SDEBUG-I-INIBRK, target system interrupted 
%DEBUG-I-DYNIMGSET, setting image SYSTEM DEBUG 
%DEBUG-I-DYNMODSET, setting module C TEST ROUTINES 

DBG> set language c ~ 

DBG> set source/latest sys$examples,sys$library 

DBG> 


OpenVMS Alpha System Dump Debugger 12-7 


OpenVMS Alpha System Dump Debugger 
12.10 Sample System Dump Debugging Session 


Now that the debugger has access to the source, you can put the debugger into 
screen mode to see exactly where you are and the code surrounding it. 


Example 12-3 Displaying the Source Code 


DBG> Set Mode Screen; Set Step Nosource 
- SRC: module C_TEST ROUTINES -scroll-source------------------------------------ 


135: int i,k; 
136: for (k=0;k<1000;k++) 
137% { 
138: test_c_code5(&i); 
139: } 
140: return; 
141: } 
142: int test_c_code3(int subrtnCount) 
143: { 
144; subrtnCount = subrtnCount - 1; 
145: if (subrtnCount != 0) 
-> 146: subrtnCount = test c code3(subrtnCount) ; 
147: return subrtnCount;  — 
148: } 
149: int test_c_code2(int64 in64,int in32, int64 test, int64* pVar) 
150: { 
15d xdt$fregsav[5] = in64; 
152: xdt$fregsav[6] = in32; 
153.5 if (xdt$fregsav[9] > 0) 
154: *pVar = (*pVar + xdt$fregsav[17])%xdtS$fregsav[9]; 
155% else 
156: *pVar = (*pVar + xdt$fregsav[17]); 
157: xdt$fregsav[7] = test c code3(10); 
- OUT -output-------------------- poe eee enn nnn n= == 5-5 == === === === === === === 


- PROMPT -error-program-prompt-------------------------------------------------- 


DBG> 
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Now, you try a couple of other commands, EXAMINE and SHOW CALLS. The 
EXAMINE command allows you to look at all the C variables. Note that the 
C_TEST_ROUTINES module is compiled with the /NOOPTIMIZE switch which 
allows access to all variables. The SHOW CALLS command shows you the call 
sequence from the beginning of the stack. In this case, you started out in the 
image EXEC_INIT. (The debugger prefixes all images other than the main image 
with SHARE$ so it shows up as SHARE$EXEC_INIT.) 


Example 12-4 Using the Examine and Show Calls Commands 


DBG> Set Mode Screen; Set Step Nosource 


- SRC: module C TEST ROUTINES -scroll-source------------------------------------ 

135: int i,k; 

136: for (k=0;k<1000;k++) 

137: { 

138: test_c_code5(&i); 

139: } 

140: return; 

141: } 

142: int test_c_code3(int subrtnCount) 

143: { 

144: subrtnCount = subrtnCount - 1; 

145: if (subrtnCount != 0) 
-> 146: subrtnCount = test c code3(subrtnCount) ; 

147: return subrtnCount; — 

148: } 

149: int test_c code2(int64 in64,int in32, int64 test, int64* pVar) 

150: { 

151: xdt$fregsav[5] = in64; 

152: xdt$fregsav[6] = in32; 

153: if (xdt$fregsav[9] > 0) 

154: *pVar = (*pVar + xdtS$fregsav[17])%xdt$fregsav[9]; 

155% else 

156: *pVar = (*pVar + xdt$fregsav[17]); 

157: xdt$fregsav[7] = test c code3(10); 
- OUT -output-------------------- een nnn nnn nnn nn nnn nnn nnn nee === == 
C TEST ROUTINES\test c code3\subrtnCount: 9 
module name routine name line rel PC abs PC 
*C_TEST ROUTINES test_c_code3 146 00000000000000CC FFFFFFFF83002D6C 
*C TEST ROUTINES test c code2 157 00000000000001A0 FFFFFFFF83002E40 
*C TEST ROUTINES test c code 170 0000000000000260 FFFFFFFF83002F00 
*XDELTA _ XDTSSYSDBG INIT 9371 0000000000000058 FFFFFFFF83052238 
*SYSSDOINIT INISDOINIT 1488 0000000000000098 FFFFFFFF830520B8 
SHARESEXEC INIT 0000000000018C74 FFFFFFFF83086C74 
SHARESEXEC_INIT 0000000000014BD0 FFFFFFFF83082BD0 


- PROMPT -error-program-prompt-------------------------------------------------- 


DBG> e subrtnCount 
DBG> show calls 


DBG> 
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Part III describes the Watchpoint utility. It presents how to use the Watchpoint 
utility by doing the following: 


e Loading the watchpoint driver 

e Creating and deleting watchpoints 

e Looking at watchpoint driver data 

e Acquiring collected watchpoint data 

e Looking at the protection attributes and access fault mechanism 


e Looking at some watchpoint restrictions 


Alpha-Only 


This utility is only available for Alpha systems on OpenVMS Version 8.2 
and earlier. 
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OpenVMS Alpha Only 


This utility runs only on OpenVMS Version 8.2 Alpha systems and earlier. 


This chapter describes the Watchpoint utility (WP), which enables you to monitor 
write access to user-specified locations. The chapter contains the following 
sections: 


Section 13.1 presents an introduction of the Watchpoint utility. 
Section 13.2 describes how to load the watchpoint driver. 


Section 13.3 describes the creation and deletion of watchpoints and the 
constraints upon watchpoint locations. 


Section 13.4 contains detailed descriptions of the watchpoint driver data 
structures, knowledge of which may be required to analyze collected watchpoint 
data. 


Section 13.5 discusses acquiring collected watchpoint data. 
Section 13.6 describes the watchpoint protection facility. 


Section 13.7 describes its restrictions. 


13.1 Introduction 


A watchpoint is a data field to which write access is monitored. The field is 
from 1 to 8 bytes long and must be contained within a single page. Typically, 
watchpoints are in nonpaged pool. However, subject to certain constraints 
(see Section 13.3.1), they can be defined in other areas of system space. The 
Watchpoint facility can simultaneously monitor a large number (50 or more) 
watchpoints. 


The utility is implemented in the WPDRIVER device driver and the utility 
program WP. This document concentrates on the device driver, which can be 
invoked directly or through the WP utility. 


For information on the WP utility, see its help files, which can be displayed with 
the following DCL command: 


$ HELP/LIBRARY=SYSSHELP : WP 


Once the driver has been loaded, a suitably privileged user can designate a 
watchpoint in system space. Any write to a location designated as a watchpoint is 
trapped. Information is recorded about the write, including its time, the register 
contents, and the program counter (PC) and processor status longword (PSL) of 
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the writing instruction. Optionally, one or both of the following user-specified 
actions can be taken: 


e An XDELTA breakpoint! or SCD breakpoint which occurs just after the write 
to the watchpoint 


e A fatal watchpoint bugcheck which occurs just after the write to the 
watchpoint 


You define a watchpoint by issuing QIO requests to the watchpoint driver; 
entering commands to the WP utility, which issues requests to the driver; or, from 
kernel mode code, invoking a routine within the watchpoint driver. 


The WPDRIVER data structures store information about writes to a watchpoint. 
This information can be obtained either through QIO requests to the WPDRIVER, 
commands to the WP utility, XDELTA commands issued during a requested 
breakpoint, or SDA commands issued during the analysis of a requested 
crashdump. 


13.2 Initializing the Watchpoint Utility 


From a process with CMKRNL privilege, run the SYSMAN utility to load the 
watchpoint driver, SYS$WPDRIVER.EXE. Enter the following commands: 

$ RUN SYSSSYSTEM: SYSMAN 

SYSMAN> IO CONNECT WPA0:/NOADAPTER/DRIVER=SYSSWPDRIVER 

SYSMAN> EXIT 

SYSMAN creates system I/O data structures for the pseudo-device WPAO, loads 
WPDRIVER, and invokes its initialization routines. WPDRIVER initialization 
includes the following actions: 


e Allocating nonpaged pool and physical memory for WPDRIVER data 
structures 


e Appropriating the SCB vector specific to access violations 


e Recording in system space the addresses of the WPDRIVER routines invoked 
by kernel mode code to create and delete watchpoints 


Memory requirements for WPDRIVER and its data structures are: 
e Device driver and UCB—approximately 3K bytes of nonpaged pool 


e Trace table and a related array—36 bytes for each of system parameter 
WPTTE_SIZE trace table entries 


e Watchpoint restore entries—system parameter WPRE_SIZE pages of 
physically contiguous memory 


e Each watchpoint—176 bytes of nonpaged pool 


It is advisable to load the watchpoint driver relatively soon after system 
initialization to ensure its allocation of physically contiguous memory. If the 
driver cannot allocate enough physically contiguous memory, it does not set 
WPAO: online. If the unit is offline, you will not be able to use the watchpoint 
utility. 


1 For simplicity, this chapter only mentions XDELTA. Any reference to XDELTA 
breakpoints also implies SCD breakpoints. 
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13.3 Creating and Deleting Watchpoints 
There are three different ways to create and delete watchpoints: 


e An image can assign a channel to device WPAO: and then request the Queue 
I/O Request ($QIO) system service to create or delete a watchpoint. 


e Code running in kernel mode can dispatch directly to routines within the 
WPDRIVER to create and delete watchpoints. 


e You can enter commands to the WP utility. 
The first two methods are described in detail in the sections that follow. 


13.3.1 Using the $QIO Interface 


An image first assigns a channel to the pseudo-device WPAO: and then issues 
a $QIO request on that channel. The process must have the privilege PHY_IO; 
otherwise, the $QIO request is rejected with the error SS$_NOPRIV. 


Table 13-1 shows the functions that the driver supports. 


Table 13-1 Driver Supported Functions 


Function Activity 

I0$_ACCESS Creates a watchpoint 

10$_DEACCESS Deletes a watchpoint 

I0$_RDSTATS Receives trace information on a watchpoint 


The IO$_ACCESS function requires the following device/function dependent 
arguments: 


e P2—Length of the watchpoint. A number larger than 8 is reduced to 8. 
e P3—Starting address of the watchpoint area. 

The following are the constraints on the watchpoint area. It must be: 

e Nonpageable system space. 

e Write-accessible from kernel mode. 


e Within one page. If it is not, the requested length is reduced to what will fit 
within the page containing the starting address. 


e Within a page accessed only from kernel mode and by instructions that incur 
no pagefaults. 


e Within a page whose protection is not altered while the watchpoint is in 
place. 


e Outside of certain address ranges. These are the WPDRIVER code, its data 
structures, and the system page table. 


Because of the current behavior of the driver, there is an additional requirement 
that there be no “unexpected” access violations referencing a page containing a 
watchpoint. See Section 13.7 for further details. 


To specify that an XDELTA breakpoint or a fatal bugcheck occur if the watchpoint 
is written, use the following I/O function code modifiers: 


e IO$M_CTRL to request an XDELTA breakpoint 
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¢ JO$M_ABORT to request a fatal bugcheck 


For an XDELTA breakpoint to be taken, OpenVMS must have been booted 
specifying that XDELTA and/or the SCD be resident (bit 1 or bit 15 in the 
boot flags must be set). If both watchpoint options are requested, the XDELTA 
breakpoint is taken first. At exit from the breakpoint, the driver crashes the 
system. 


A request to create a watchpoint can succeed completely, succeed partially, or fail. 
Table 13-2 shows the status codes that can be returned in the I/O status block. 


Table 13-2 Returned Status Codes 


Status Code Meaning 
SS$_NORMAL Success. 
SS$_BUFFEROVF A watchpoint was established, but its length is less than 


was requested because the requested watchpoint would have 
straddled a page boundary. 


SS$_EXQUOTA The watchpoint could not be created because too many 


watchpoints already exist. 


SS$_INSFMEM The watchpoint could not be created because there was 


insufficient nonpaged pool to create data structures specific 
to this watchpoint. 


SS$_IVADDR The requested watchpoint resides in one of the areas in 


which the WPDRIVER is unable to create watchpoints. 


SS$_WASSET An existing watchpoint either coincides or overlaps with the 


requested watchpoint. 


The following example MACRO program assigns a channel to the WPAO device 
and creates a watchpoint of 4 bytes, at starting address 80001068. The program 
requests neither an XDELTA breakpoint nor a system crash for that watchpoint. 


WP_IOSB: 


START: 


RETURN: 


SIODEF 

.PSECT RWDATA,NOEXE,RD,WRT,LONG 

. BLKL 2 + I/O status block. 

. LONG *X80001068 ; Address of watchpoint to create. 
-ASCID /WPAO:/ ; Device to which to assign channel. 
. BLKW ul + Channel number. 


-PSECT PROG, EXE,NOWRT 


-CALL_ ENTRY 


SASSIGN_S DEVNAM=WP_NAM,CHAN=WP_CHAN 
BLBC RO,RETURN 


$QIOW_S CHAN=WP_CHAN, - 
FUNC=#10$_ ACCESS, - 
IOSB=WP_IOSB, - 


P2=#4,- 

P3=WP ADDR 
BLBC RO, RETURN 
MOVL WP IOSB,RO ; Move status to RO. 
RET ~ + Return to caller. 
END START 


A watchpoint remains in effect until it is explicitly deleted. (Note, however, that 
watchpoint definitions do not persist across system reboots.) To delete an existing 
watchpoint, issue an IO$_DEACCESS QIO request. 
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The IO$_DEACCESS function requires the following device/function dependent 
argument: P3 - Starting address of the watchpoint to be deleted. 


Table 13-3 shows the status values that are returned in the I/O status block. 


Table 13-3 Returned Status Values 


Status Value Meaning 
SS$_NORMAL Success. 
SS$_IVADDR The specified watchpoint does not exist. 


Section 13.5 describes the use of the IO$_RDSTATS QIO request. 


13.3.2 Invoking WPDRIVER Entry Points from System Routines 


When the WPDRIVER is loaded, it initializes two locations in system space 
with the addresses of routines within the driver. These locations, WP$CREATE_ 
WATCHPOINT and WP$DELETE_WATCHPOINT, enable dispatch to create and 
delete watchpoint routines within the loaded driver. Input arguments for both 
routines are passed in registers. 


Code running in kernel mode can execute the following instructions: 
JSB @G“WP$CREATE WATCHPOINT ; create a watchpoint 
and 
JSB @G"“WP$DELETE WATCHPOINT ; delete a watchpoint 


Both these routines save IPL at entry and set it to the fork IPL of the 
WPDRIVER, IPL 11. Thus, they should not be invoked by code threads running 
above IPL 11. At exit, the routines restore the entry IPL. 


These two locations contain an RSB instruction prior to the loading of the driver. 
As a result, if a system routine tries to create or delete a watchpoint before the 
WPDRIVER is loaded, control immediately returns. 


WP$CREATE_WATCHPOINT has the following register arguments: 
e RO—User-specified watchpoint options 


— Bit 1 equal to 1 specifies that a fatal OPERCRASH bugcheck should occur 
after a write to the watchpoint area. 


— Bit 2 equal to 1 specifies that an XDELTA breakpoint should occur after a 
write to the watchpoint area. 


e R1—Length of the watchpoint area 
e R2—Starting address of the watchpoint area 


Status is returned in RO. The status values and their interpretations are identical 
to those for the QIO interface to create a watchpoint. The only difference is that 
the SS$_NOPRIV status cannot be returned with this interface. 


WPS$DELETE_WATCHPOINT has the following register argument: 
e R2—Starting address of the watchpoint area 


Status is returned in RO. The status values and their interpretations are identical 
to those for the QIO interface. 
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13.4 Data Structures 
The WPDRIVER uses three different kinds of data structures: 


e One watchpoint restore entry (WPRE) for each page of system space in which 
one or more active watchpoints are located 


e One watchpoint control block (WPCB) for each active watchpoint 


e Trace table entries (WPTTEs) in a circular trace buffer which maintains a 
history of watchpoint writes 


These data structures are described in detail and illustrated in the sections that 
follow. 


13.4.1 Watchpoint Restore Entry (WPRE) 


There is one WPRE for each system page that contains a watchpoint. That is, 
if nine watchpoints are defined which are in four different system pages, four 

WPREs are required to describe those pages. When WPDRIVER is loaded, its 
initialization routine allocates physically contiguous memory for the maximum 
number of WPREs. The number of pages to be allocated is specified by system 
parameter WPRE_SIZE. 


The WPDRIVER allocates WPREs starting at the beginning of the table and 
maintains a tightly packed list. That is, when a WPRE in the middle of those 
in use is “deallocated,” its current contents are replaced with the contents of 
the last WPRE in use. The number in use at any given time is in the driver 
variable WP$L_WP_COUNT. The system global EXE$GA_WP_WPRE points to 
the beginning of the WPRE table. 


The WPRE for a page contains information useful for: 


e Determining whether a given access violation refers to an address in the page 
associated with this WPRE 


e Restoring the original SPTE value for the associated page 
e Reestablishing the modified SPTE value when watchpoints are reenabled 
e Invalidating the translation buffer when the SPTE is modified 


e Locating the data structures associated with individual watchpoints defined 
in this system page 


13.4.2 Watchpoint Control Blocks (WPCB) 


The WPCBs associated with a given system page are singly-linked to a list 
header in the associated WPRE. A WPCB is allocated from a nonpaged pool 
when a watchpoint is created. A WPCB contains static information about the 
watchpoint such as the following: 


e Its starting address and length 
e Original contents of the watchpoint at the time it was established 
e User-specified options for this watchpoint 


In addition, the WPCB contains dynamic data associated with the most recent 
write reference to the watchpoint. This data includes the following: 


e Number of times that the watchpoint has been written. 


e Address of the first byte within the watchpoint that was modified at the last 
write reference. 
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e PC-PSL pair that made the last write reference. 
e System time at the last write reference. 
e Contents of the general registers at the time of the last write reference. 


e Acopy of up to 15 bytes of instruction stream data beginning at the program 
counter (PC) of the instruction that made the last write reference. The 
amount of instruction stream data that is copied here is the lesser of 15 bytes 
and the remaining bytes on the page containing the PC. 


e Contents of the watchpoint before the last write reference. 


e Contents of the watchpoint after the last write reference. This value is 
presumably the current contents of the watchpoint. 


e A pointer to an entry in the global circular trace buffer where all recent 
references to watchpoints are traced. 


13.4.3 Trace Table Entries (WPTTEs) 


Whenever a watchpoint is written, all the relevant data is recorded in the 
WPCEB associated with the watchpoint. In addition, to maintain a history, the 
WPDRIVER copies a subset of the data to the oldest WPTTE in the circular 
trace buffer. Thus, the circular trace buffer contains a history of the last N 
references to watchpoints. The driver allocates nonpaged pool to accommodate 
the number of trace table entries specified by the system parameter WPTTE_ 
SIZE. The WPTTEs for all watchpoints are together in the table, but the ones for 
a particular watchpoint are chained together. 


The subset of data in a WPTTE includes the following: 

e Starting address of the watchpoint 

e Relative offset of the first byte modified on this reference 

e Opcode of the instruction that modified the watchpoint 

e A relative backpointer to the previous WPTTE of this watchpoint 
e PC-PSL of the write reference 

e System time of the write reference 


e Contents of the watchpoint before this reference 


13.5 Analyzing Watchpoint Results 


Analyzing watchpoint results is a function of the mode in which the WPDRIVER 
is used. For example, if you have only one watchpoint and have specified that an 
XDELTA breakpoint and/or a bugcheck occur on a write to the watchpoint, then 
when the reference occurs, simply find the program counter (PC) that caused the 
reference. 


This PC (actually the PC of the next instruction) and its processor status 
longword (PSL) are on the stack at the time of the breakpoint and/or bugcheck. 
The layout that follows is the stack as it appears within an XDELTA breakpoint. 
Examined from a crash dump, the stack is similar but does not contain the return 
address from the JSB to INI$BRK. 
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address in WPDRIVER from JSB G* INISBRK | :SP 
PC of next instruction 
PSL at watchpoint access 


Furthermore, RO contains the address of the WPCB associated with that 
watchpoint. You can examine the WPCB to determine the original contents of the 
watchpoint area and the registers at the time of the write. 


Definitions for the watchpoint data structures are in SYS$LIBRARY:LIB.MLB. 
Build an object module with its symbol definitions by entering the following DCL 
commands: 


S$ MACRO/OBJ=SYSSLOGIN:WPDEFS SYSSINPUT: + SYSSLIBRARY:LIB/LIB 
SWPCBDEF GLOBAL !'n.b. GLOBAL must be capitalized 
SWPREDEF GLOBAL 
SWPTTEDEF GLOBAL 
» END 

CTRL/Z 


Then, within SDA, you can format watchpoint data structures. For example, 
enter the following SDA commands: 


SDA>READ SYSSLOGIN:WPDEFS.OBJ 

SDA>FORMAT @ROQ /TYPE=WPCB type definition is required 
SDA>DEF WPTTE = @RO + WPCBSL TTE 

SDA>FORMAT WPTTE /TYPE=WPTTE — 


An alternative to crashing the system or using XDELTA to get watchpoint 
information is the QIO function IO$_RDSTAT. This function returns watchpoint 
control block contents and trace table entries for a particular watchpoint. 


It requires the following device/function dependent arguments: 
e  P1—Address of buffer to receive watchpoint data. 


e P2—Length of the buffer. The minimum size buffer of 188 bytes is only large 
enough for WPCB contents. 


e P3—Watchpoint address. 
The data returned in the buffer has the format shown in Figure 13-1. 
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Figure 13-1 Format of Data Returned in Buffer 


Number of bytes copied to buffer 


Total number of WPTTEs for watchpoint 


Number of WPTTEs copied to buffer 
WPCB 


Most recent WPTTE 
Next recent WPTTE 


Next WPTTE 


si Next WPTTE 7 


VM-0970A-Al 


13.6 Watchpoint Protection Overview 


The overall design of the watchpoint facility uses protection attributes on system 
pages and the access violation fault mechanism. To establish a watchpoint within 
a page of system space, the WPDRIVER changes the protection of the page to 
disallow writes. The WPDRIVER modifies the access violation vector to point to 
its own routine, WP$ACCVIO. 


Any subsequent write to this page causes an access violation and dispatch to 
WP$ACCVIO. Thus, the WPDRIVER gains control on all write references to 
watchpoints and can monitor such accesses. 


When WP$ACCVIO is entered, it raises IPL to 31 to block all other threads of 
execution. It first must determine whether the faulting address (whose reference 
caused the access violation) is within a page containing a watchpoint. However, 
any major amount of CPU processing at this point might access an area in system 
space whose protection has been altered to establish watchpoints. As a result, 
such processing might cause a reentry into WP$ACCVIO. To avoid recursive 
reentry, WP$ACCVIO first restores all SPTEs that it had modified to their values 
prior to the establishment of any watchpoints. From this point until this set 

of SPTEs are remodified, no watchpoints are in effect. Now WP$ACCVIO can 
determine whether the reference was to a page containing a watchpoint. 


To determine whether the reference is to a watchpoint page, WP$ACCVIO 
compares the faulting address to addresses of pages whose protection has been 
altered by WPDRIVER. If the faulting address is not in one of these pages, 
then WP$ACCVIO passes the access violation to the usual OpenVMS service 
routine, EXE$ACVIOLAT. If the faulting address is within a page containing a 
watchpoint, more extensive processing is required. 


As a temporary measure, WP$ACCVIO first records all data related to the 
reference in its UCB. It cannot immediately associate the access violation with 
a particular watchpoint. This ambiguity arises from imprecision in the faulting 
virtual address recorded at the access violation. The CPU need merely place on 
the stack “some virtual address in the faulting page.” 
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As a result, when a reference to a page with a watchpoint results in an access 
violation, the watchpoint driver first merely captures the data in its UCB. The 
data captured at this point includes the following: 


e PC and PSL of the faulting instruction 
e Current system time 
e Values of all the general registers from RO through SP 


e A copy of up to 15 bytes of the instruction stream, beginning at the PC 
previously captured 


If the reference later turns out not to be one to a watchpoint, the captured data 
is discarded. If the reference is to a watchpoint, the data is copied to the WPCB 
and circular trace buffer. 


The watchpoint driver distinguishes between these two possibilities by 
reexecuting the faulting instruction under a controlled set of circumstances. 


Once the instruction has reexecuted, WP$TBIT can determine whether 
watchpoint data has been modified by comparing the current contents of all 
watchpoints within the page of interest to the contents that they had prior to 
this reference. Because the driver has run at IPL 31 since the write access that 
caused an access violation, any change in the contents is attributable to the 
reexecuted instruction. If the contents of a watchpoint are different, WP$TBIT 
copies the data temporarily saved in its UCB to the WPCB associated with this 
watchpoint and records a subset of this data in a WPTTE. 


The driver can cause either or both an XDELTA breakpoint or a bugcheck, 
depending on what action was requested with the watchpoint definition. If an 
XDELTA breakpoint was requested, the driver invokes XDELTA. After the user 
proceeds from the XDELTA breakpoint, if a bugcheck was not requested, the 
driver restores the SPTEs of pages containing watchpoints, the saved registers 
and IPL, and REIs to dismiss the exception. 


13.7 Restrictions 


The WPDRIVER can monitor only those write references to system space 
addresses that arise in a CPU. I/O devices can write to memory and thereby 
modify watchpoints without the WPDRIVER’s becoming aware of the write. 


Because a write access to a watchpoint is determined by comparing the contents 
of the watchpoint before and after the write, a write of data identical to the 
original contents is undetectable. 


Because the WPDRIVER modifies SPTEs, a device page that directly interprets 
tables may experience access violations when it attempts to write into a memory 
page whose protection has been modified to monitor watchpoints. In other 
words, a page containing a watchpoint should not also contain a buffer for such a 
controller. 


When you create a watchpoint, you should ensure that the system is quiet with 
respect to activity affecting the watchpoint area. Otherwise, an inconsistent copy 
of the original contents of the watchpoint area may be saved. WPDRIVER raises 
IPL to 11 to copy the watchpoint area’s original contents. This means that if the 
area is modified from a thread of execution running as the result of an interrupt 
above 11, WPDRIVER can copy inconsistent contents. An inconsistent copy of the 
original contents may result in spuriously detected writes and missed writes. 
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If the page containing the watchpoint area is written by an instruction that 
incurs a page fault, the system can crash with a fatal PGFIPLHI bugcheck. As 
described in the previous section, after detecting an attempt to write to a page 
with a watchpoint, the WPDRIVER re-executes the writing instruction at IPL 31. 
Page faults at IPL 31 are not allowed. 


If an outer access mode reference to a watchpointed page causes an access 
violation, the system will likely crash. When an access violation occurs on a page 
with a watchpoint, the current driver does not probe the intended access and 
faulting mode against the page’s original protection code. Instead, it assumes 
that any access violation to that page represents a kernel mode instruction that 
can be reexecuted at IPL 31. The driver’s subsequent attempt to REI, restoring a 
program status longword (PSL) with an outer mode and IPL 31, causes a reserved 
operand fault and, generally, a fatal INVEXCEPTN bugcheck. 


You must be knowledgeable about the accesses to the page with the watchpoint 
and careful in using the driver. You should test the watchpoint creation on a 
standalone system. You should leave the watchpoint in effect long enough to have 
some confidence that pagefaults in instructions accessing that page are unlikely. 


An attempt to CONNECT a WPA unit other than zero results in a fatal 
WPDRVRERR bugcheck. 


The WPDRIVER is suitable for use only on a single CPU system. That is, it 
should not be used on a symmetric multiprocessing system. There are no plans to 
remove this restriction in the near future. 
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OpenVMS System Service Logging Utility 


Part IV describes the System Service Logging utility. It explains how to: 
e Start logging 
e Stop logging 


e Display logged information 


14 


System Service Logging 


This chapter presents an overview of the System Service Logging utility and 
describes the System Service Logging commands. 
14.1 Overview 


System service logging (SSLOG) is used to record system service activity in a 
process. Its primary purpose is to troubleshoot process failure or misbehavior. 
This utility is available on OpenVMS Alpha and 164 platforms. 


Once enabled, the SSLOG mechanism records information about system services 
requested by code running in the context of that process. The system services 
logged are: 


e Executive and kernel-mode services 

e Within privileged shareable image services 
e Within the OpenVMS executive 

SSLOG does not log the mode of caller services. 


SSLOG information is initially recorded in process space buffers. When a buffer 
is full, it is written to a disk file in the process’s default disk and directory. After 
the disk file is closed, you can analyze it with the ANALYZE/SSLOG utility. 


Recorded Information 
SSLOG records the following information for each service: 


e Service identification 
e Location of service request - image and offset 
e Access mode of requestor 


e Service arguments (passed by value; only the addresses of arguments passed 
by reference) 


e Timestamp 
e Completion status 
The information is recorded as follows: 


e Initially in a ring of P2 space buffers (each process has its own P2 space 
buffers) 


e A full buffer is written to the file SSLOG.DAT in the current default disk and 
directory 
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14.2 Enabling Logging 


To enable any system service logging, check that the dynamic system parameter 
SYSSER_LOGGING is 1. If not, set it to a value of 1. Once logging is enabled, 
you can start system service logging for a particular process by DCL command, 
as shown in the following example. 


$ SET PROC/SSLOG=(STATE=ON, COUNT=4 ,SIZE=%XFE00) 


By default, execution of this command affects the current process. To target 
another process, use the /ID qualifier or specify the process by name. 


To specify P2 space buffers of the process you are logging: 
e Specify the number with COUNT 

e Specify the size in bytes with SIZE (larger is better) 
Buffers: 

e Are pageable and thus charged against P@FLQUOTA 
e Are not deallocated until process deletion 


For additional information on this command, see the command SET 
PROCESS/SSLOG. 


14.3 Disabling Logging 
To disable logging, use the SET PROCESS DCL command: 
$ SET PROC/SSLOG=(STATE=OFF) 
or 
$ SET PROC/SSLOG=(STATE=UNLOAD) 
STATE=OFF stops logging, but it can be re-enabled again. STATE=UNLOAD 
stops logging and closes SSLOG.DAT 
14.4 Displaying Logged Information 


You display logged information with the DCL command ANALYZE/SSLOG filename, 
where the default filename is SSLOG.DAT. For additional information on this 
command and examples, see the command ANALYZE/SSLOG . 


14-2 System Service Logging 


System Service Logging 
ANALYZE/SSLOG 


ANALYZE/SSLOG 


Format 


Parameters 


Qualifiers 


Displays the collected data. 


ANALYZE/SSLOG_  [/BRIEF | /FULL | /NORMAL | /STATISTICS] 
[/OUTPUT=filename] [/SELECT=(optionf,...])] [WIDE] [filespec] 


filespec 
Optional name of the log file to be analyzed. The default filename is SSLOG.DAT. 


option 
Keyword for data to be displayed with the /SELECT qualifier. Table 14—1 lists 
the keywords that may be used, with their meanings. 


/BRIEF 
Displays abbreviated logged information. 


/FULL 
Displays logged information, error status messages and sequence numbers. 


/NORMAL 
Displays basic logged information. This is the default. 


/OUTPUT=filename 
Identifies the output file for storing the results of the log analysis. An asterisk (*) 
and percent sign (%) are not allowed as wildcards in the file specification. There 


is no default file type or filename. If you omit the qualifier, results are output to 
the current SYS$OUTPUT device. 


/SELECT=([option[....]]) 

Selects entries based on choice of ACCESS_MODE, IMAGE, STATUS or SYSSER 
options. See Table 14—1 for the options and their meanings. At least one must be 
supplied. 


/STATISTICS[=BY_STATUS] 

Displays statistics on system services usage; accepts BY_STATUS keyword. 
Outputs a summary of the services logged with a breakdown by access mode. 
Output is ordered with the most frequently requested services first. If BY_ 
STATUS is included, the summary is further separated by completion status. 
Output is displayed up to 132 columns wide. 


/WIDE 
Provides for a display of logged information up to 132 columns wide. 
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Description 


Examples 


The ANALYZE/SSLOG command displays the collected logged data. Note that 
a system service log must be analyzed on the same platform type as the one on 
which it was created; for example, a log created on an OpenVMS Alpha system 
must be analyzed on an OpenVMS Alpha system. 


Table 14-1 describes the available options. 


Table 14-1 SELECT Qualifer Keywords 


Keyword Meaning 


ACCESS_MODE=mode 
IMAGE=imagename 
STATUS[=n] 


Selects data by access mode. 
Selects data by imagename. 


Selects data by status. n is optional. 
/SELECT=STATUS displays all entries that 
have error statuses. 


SYSSER=servicename Selects data by servicename. 


The following examples show use of the ANALYZE/SSLOG command. Where 
examples are wide, system output has been moved left. 


1. $ ANAL/SSLOG/BRIEF 


START 1.1 00000414 HERE IA64 !25-MAY-2004 14:55:17.77 
NAK :: SYSTEM 4 65024 
SYSSEXIT INT sts: -------- acmode: U 114:55:17.80 
image: IMAGE MANAGEMENT+00047ed0 argct: 01 
SYSS$RMSRUNDWN sts: 00010001 acmode: S !14:55:17.80 
image: DCL+00070370 argct: 02 
SYSSDCLAST sts: 00000001 acmode: E $14:55:17.80 
image: RMS+000e5840 argct: 03 
SYSSRMS CLOSE sts: 00010001 acmode: E !14:55:17.80 
image: RMS+000d66c0 argct: 03 
SYSSSETEF sts: 00000009 acmode: E 114:55:17.80 
image: RMS+00125df£0 argct: 01 
SYSSRMS CLOSE sts: 00010001 acmode: E !14:55:17.80 
image: RMS+000d66c0 argct: 03 
SYSSSETEF sts: 00000009 acmode: E 114:55:17.80 
image: RMS+00125df0 argct: 01 
SYSSERNDWN sts: 00000001 acmode: S$ 114:55:17.80 
image: IMAGE MANAGEMENT+000274d0 argct: 01 
SYSSCMKRNL sts: 8318ae00 acmode: E 114:55:17.80 
image: IMAGE MANAGEMENT+00027890 argct: 02 


evel 


This example shows abbreviated SSLOG output. 


The first entry displayed is a START message that describes the enabling of 

system service logging. The major and minor version numbers associated with 
this log file are both 1. Logging was initiated by process ID 0000041416 whose 
username was SYSTEM. This log file is from an OpenVMS 164 platform. The 
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timestamp shows when logging was started. The process whose services were 
logged was named HERE and ran on node NAK. Logging was done into four 
buffers of 65024 bytes each. 


Each subsequent entry describes a system service request. The leftmost column 
is the service name. The next item displayed is the hexadecimal completion 
status from that service request. If the status is displayed as “ ” one of the 
following circumstances occurred: 


e The buffer filled and was written to disk before the service completed. 


e The service returned to the system service dispatcher at an interrupt priority 
level (IPL) above 2. Because the process space buffers are pageable and page 
faults are not allowed above IPL 2, completion status cannot be logged when 
a service returns above IPL 2. 


The next item displayed is the access mode from which the service was requested, 
followed by the time at which the service was requested. The next line shows 
the image and offset within the image of the service request and the number 

of arguments with which the service was requested. Service arguments are not 
displayed when you enter the command ANALYZE/SSLOG/BRIEF. 


2. $ anal/sslog/br/wide 


START Lt 20200224 HERE2 XK150S::USER ALPHA !28-APR-2004 14:17:58.54 
service status mode imagenametoffset time 
SYSSEXIT_INT secccoe- U IMAGE MANAGEMENT+00010838 $14:17:58.82 
SYSSRMSRUNDWN 00010001 i) DCL. EXE+000804b0 $14:17:58.82 
SYSSDCLAST 00000001 &£ RMS+0004e200 $14:17:58.82 
SYS$RMS_CLOSE 00010001 £ RMS+000484b8 $14:17:58.82 
SYSSSETEF 00000009 £E RMS+0005f£e70 $14:17:58.82 
SYSSRMS CLOSE 00010001 &£ RMS+000484b8 $14:17:58.82 
SYSSSETEF 00000009 £ RMS+0005£e70 $14:17:58.82 
SYSSERNDWN 00000001 S$ IMAGE MANAGEMENT+0000a1b4 $14:17:58.82 
SYSSCMKRNL 810bdd00 &£E IMAGE MANAGEMENT+0000a2b8 $14:17:58.82 
SYSSSETRWM 00000001 E IMAGE MANAGEMENT+0000a2cc $14:17:58.82 
SYSSSETRWM 00000001 E IMAGE MANAGEMENT+0000a3ac $14:17:58.82 
SYSSKRNDWN 00000001 S$ IMAGE MANAGEMENT+0000alc8 $14:17:58.82 
SYSSSETRWM 00000001 K IMAGE MANAGEMENT+0000a730 $14:17:58.82 
SYSSSETPFM 000002dc kK IMAGE MANAGEMENT+0000a9b4 $14:17:58.82 
SYSSDASSGN 0000026c kK IMAGE MANAGEMENT+0000aa3c $14:17:58.82 
SYSSQIO 0000026c kK IO_ROUTINES MON+00024294 $14:17:58.82 
SYSSDASSGN 00000001 kK IMAGE MANAGEMENT+0000aa3c $14:17:58.82 
SYSSQIO 00000001 K IO_ROUTINES MON+00024294 $14:17:58.82 


[eae] 
This example shows abbreviated SSLOG output in a wide format. 


3. $ ANAL/SSLOG/FULL 


START version: 1.1 process: 00000414 HERE !25-MAY-2004 14:55:17.77 
username: SYSTEM node: NAK platform: IA64 
buffer count: 4 size: 65024 start flags: 00000003 
SYSS$EXIT_INT sts: -------- acmode: U- !14:55:17.80 
image: IMAGE MANAGEMENT+00047ed0 argct: 01 


arg 1:0000000010000001 
entry number: 00000002 number at completion: 00000000 
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SYSSRMSRUNDWN acmode: S $14:55:17.80 
sts: @RMS-S-NORMAL, normal successful completion 
image: DCL+00070370 argct: 02 


arg 1:000000007ffabf14 2:0000000000000000 
entry number: 00000003 number at completion: 00000008 


SYSSDCLAST acmode: E $14:55:17.80 
sts: @SYSTEM-S-NORMAL, normal successful completion 
image: RMS+000e5840 argct: 03 


arg 1:ffffffff£832£70b0 2:0000000000000002 3:0000000000000000 
entry number: 00000004 number at completion: 00000004 


SYS$RMS_CLOSE acmode: E $14:55:17.80 
sts: @RMS-S-NORMAL, normal successful completion 
image: RMS+000d66c0 argct: 03 


arg 1:000000007£f67e20 2:0000000000000000 3:0000000000000000 
entry number: 00000005 number at completion: 00000006 


SYSSSETEF acmode: E $14:55:17.80 
sts: %SYSTEM-S-ACCVIO, access violation, reason mask=!XB, virtual address=!XH, PC=!XH, PS=!XL 
image: RMS+00125d£0 argct: 01 


arg 1:000000000000001e 
entry number: 00000006 number at completion: 00000006 


SYS$RMS_CLOSE acmode: E $14:55:17.80 
sts: @RMS-S-NORMAL, normal successful completion 
image: RMS+000d66c0 argct: 03 


arg 1:000000007£f67e20 2:0000000000000000 3:0000000000000000 
entry number: 00000007 number at completion: 00000008 


SYSSSETEF acmode: E $14:55:17.80 
sts: %SYSTEM-S-ACCVIO, access violation, reason mask=!XB, virtual address=!XH, PC=!XH, PS=!XL 
image: RMS+00125d£0 argct: 01 


arg 1:000000000000001e 
entry number: 00000008 number at completion: 00000008 


SYSSERNDWN acmode: S$ $114:55:17.80 
sts: @SYSTEM-S-NORMAL, normal successful completion 
image: IMAGE MANAGEMENT+000274d0 argct: 01 


arg 1:0000000000000003 
entry number: 00000009 number at completion: 0000000C 


SYSSCMKRNL acmode: E $114:55:17.80 
sts: %NONAME-W-NOMSG, Message number 8318AE00 
image: IMAGE MANAGEMENT+00027890 argct: 02 


arg 1:fffffff£f8330d420 2:0000000000000000 
entry number: 0000000A number at completion: 0000000A 


This example shows full SSLOG output. 


In the /FULL display, the START entry also shows the flags with which logging 
was initiated: 


e Bit 0, when set, means that service arguments were logged. 


e Bit 1, which is always set, means that the P2 space buffers are being written 
to a file. 


The /FULL display shows the arguments for each system service request, as well 
as its entry number, and interprets the completion status. 


When logging is initiated for a particular service, an entry sequence number 

is associated with that entry. The sequence number is incremented with each 
attempt to log a system service. The /FULL display shows the sequence number 
associated with each service request and the number current at the time the 
service completed. If the service requests no other loggable system services, the 
two numbers are identical; otherwise, the two numbers differ. 


Note that the number at completion is 0 for a service whose completion status 
could not be logged. 
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In this example, the number when SYS$RMSRUNDWN is requested is 3, and 
the number at completion is 8. From this you can infer that five other services 
were requested as part of processing the SYS$RMSRUNDWN request, namely, 
the services whose entry numbers are 4 through 8. 


4. $§ anal/sslog/norm 


START version: 1.1 process: 00000414 HERE 
username: SYSTEM 


buffer count: 4 


SYSSEXIT_INT 
image: 
arg 

entry 


SYSSRMSRUNDWN 
image: 


arg 1: 


entry 


SYSSDCLAST 
image: 
arg 1 
entry 


SYS$RMS CLOSE 
image: 


arg 1: 


entry 


SYSSSETEF 
image: 


arg 1: 


entry 


SYSSRMS CLOSE 
image: 


arg 1: 


entry 


1: 


!25-MAY-2004 14:55:17.77 


node: NAK platform: IA64 
size: 65024 start flags: 00000003 
sts: -------- acmode: U $14:55:17.80 
IMAGE MANAGEMENT+00047ed0 argct: 01 
0000000010000001 
number: 00000002 number at completion: 00000000 
sts: 00010001 acmode: S !14:55:17.80 
DCL+00070370 argct: 02 
000000007ffabf14 2:0000000000000000 
number: 00000003 number at completion: 00000008 
sts: 00000001 acmode: E $14:55:17.80 
RMS+000e5840 argct: 03 
:fff£fLLLL832£70b0 2:0000000000000002 3:0000000000000000 
number: 00000004 number at completion: 00000004 
sts: 00010001 acmode: E $14:55:17.80 
RMS+000d66c0 argct: 03 
000000007££67e20 2:0000000000000000 3:0000000000000000 
number: 00000005 number at completion: 00000006 
sts: 00000009 acmode: E !14:55:17.80 
RMS+00125df£0 argct: 01 
00000000000000le 
number: 00000006 number at completion: 00000006 
sts: 00010001 acmode: E $14:55:17.80 
RMS+000d66c0 argct: 03 
000000007££67e20 2:0000000000000000 3:0000000000000000 


number: 00000007 number at completion: 00000008 


This example shows normal SSLOG output in narrow format. 


The difference between the /NORMAL and /FULL displays is that the service 
completion status is interpreted in a /FULL display. 


5. $§ anal/sslog/wide 


START version: 


username: 


1.1 process: 20200224 HERE2 !28-APR-2004 14:17:58.54 
USER node: NODEAZ platform: ALPHA 


SYSSEXIT_INT sts: -------- acmode: U image: IMAGE MANAGEMENT+00010838 !14:17:58.82 
argct:01 1:0000000010000001 

SYSSRMSRUNDWN sts: 00010001 acmode: S image: DCL. EXE+000804b0 $14:17:58.82 
argct:02 1:000000007ff9cb34 2:0000000000000000 

SYSSDCLAST sts: 00000001 acmode: E image: RMS+0004e200 $14:17:58.82 

argct:03 1:00000000811338b0 2:0000000000000002 3:0000000000000000 
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SYS$RMS_CLOSE sts: 00010001 acmode: E image: RMS+000484b8 114:17:58.82 
argct:03 1:000000007ff8beb0 2:0000000000000000 3:0000000000000000 


SYSSSETEF sts: 00000009 acmode: E image: RMS+0005fe70 $14:17:58.82 
arget:01 1:000000000000001e 


SYS$RMS_CLOSE sts: 00010001 acmode: E image: RMS+000484b8 $14:17:58.82 
argct:03 1:000000007ff8beb0 2:0000000000000000 3:0000000000000000 


SYSSSETEF sts: 00000009 acmode: E image: RMS+0005fe70 114:17:58.82 
arget:01 1:000000000000001e 
[aval 


This example shows normal (default) SSLOG output in a wide format. 


6. $§ anal/sslog/wide/full 


START version: 1.1 process: 00000415 HERE !11-MAY-2004 10:41:38.82 
username: SYSTEM node: NAK platform: IA64 
SYSS$EXIT_INT sts: -------- acmode: U image: IMAGE MANAGEMENT+00047600 $110:41:38.85 
argct:01 1:0000000010000001 entry number: 00000002 number at completion: 00000000 
SYSSRMSRUNDWN acmode: S$ _ image: DCL+0006fdb0 $110:41:38.85 


sts: @RMS-S-NORMAL, normal successful completion 
argct:02 1:000000007ffab£14 2:0000000000000000 
entry number: 00000003 number at completion: 00000008 


SYSSDCLAST acmode: E image: RMS+000e3ca0 110:41:38.85 
sts: @SYSTEM-S-NORMAL, normal successful completion 
argcet:03 1:ffffffff842f68b0 2:0000000000000002 3:0000000000000000 
entry number: 00000004 number at completion: 00000004 


SYSS$RMS CLOSE acmode: E image: RMS+000d4d90 $10:41:38.85 
sts: $RMS-S-NORMAL, normal successful completion 
argct:03 1:000000007ff67e20 2:0000000000000000 3:0000000000000000 
entry number: 00000005 number at completion: 00000006 


SYSSSETEF acmode: E image: RMS+00123740 110:41:38.85 
sts: %SYSTEM-S-ACCVIO, access violation, reason mask=!XB, virtual address=!XH, PC=!XH, PS=!XL 
argct:01 1:000000000000001e 
entry number: 00000006 number at completion: 00000006 


SYSS$RMS CLOSE acmode: E image: RMS+000d4d90 $10:41:38.85 
sts: %RMS-S-NORMAL, normal successful completion 
argct:03 1:000000007ff67e20 2:0000000000000000 3:0000000000000000 
entry number: 00000007 number at completion: 00000008 


This example shows full SSLOG output in a wide format. 


7. $ ANALYZE/SSLOG/WIDE/SELECT= - 
( IMAGE=DCL, SYSSER=SYS$IMGACT) /OUT=SSL_SEL2.LOG SSLOG.DAT 


The file SSL_SEL2.LOG contains the following: 


START version: 1.1 process: 2020041b SYSTEM !30-AUG-2004 18:30:28.79 
username: SYSTEM node: WFGLX4 platform: ALPHA 
SYSSIMGACT sts: 00000001 acmode: S image: DCL+0007eb40 118:30:44.26 


argct:08 1:000000007££9cd58 2:000000007££9Cd50 3:000000007fEc£800 4:0000000000000000 
5:0000000000000000 6:0000000000000000 7:0000000000000000 8:0000000000000000 
entry number: 0000002E number at completion: 000000B7 


SYSSIMGACT sts: 00000001 acmode: S image: DCL+0007eb40 118:30:49.81 
argcet:08 1:000000007££9cd58 2:000000007fF9Cd50 3:000000007£Fc£800 4:0000000000000000 
5:0000000000000000 6:0000000000000000 7:0000000000000000 8:0000000000000000 
entry number: 00000195 number at completion: 00000203 
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image: 
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DCL+0007eb40 $18:31:06.19 


argcet:08 1:000000007££9cd58 2:000000007F£9cd50 3:000000007ffcf800 4:0000000000000000 
5:0000000000000000 6:0000000000000000 7:0000000000000000 8:0000000000000000 
number at completion: 0000046A 


entry number: 000003FB 


STOP 


130-AUG-2004 18:31:06.19 


This example selects only those entries that describe SYS$IMGACT requests 
made from DCL and writes the analysis to file SSL_SEL2.LOG. (Parts of the 
display have been moved left to fit within manual page boundaries.) 


8. $ ANALYZE/SSLOG/STATISTICS/OUT=SSL_STAT.LOG SSLOG.DAT 
The file SSL_STAT.LOG contains the following: 


START version: 1.1 process: 2020041b SYSTEM 130-AUG-2004 18:30:28.79 


username: SYSTEM 


buffer count: 2 size: 


Service 

SYSSTRNLNM 

SYSS$RMS_ SEARCH 
SYSSQIO 

SYSS$SYNCH INT 
SYSSRMS_ PUT 
SYSSCMKRNL 
SYSSSETPRT 
SYSSDASSGN 
SYSS$GETDVI 
SYSSASSIGN_LOCAL 
SYSSMGBLSC 
SYSSCRMPSC 
SYSSGETJPI 
SYSS$RMS_OPEN 
SYSSDEQ 

SYSSIMGACT 
SYSSCRETVA 

SYSSENQ 

SYSSSETRWM 
SYSS$DELTVA 
SYSSPERSONA ASSUME 
SYSSEXPREG 
SYSSRMS CLOSE 
SYSSCLRCLUEVT 
SYSSSETEF 
SYSSDACEFC 
SYSS$PERSONA EXTENSION LOOKUP 
SYSSGETSYI — 7 
SYSSDCLAST 
SYSSRMSRUNDWN 
SYSSERNDWN 
SYSSSETEXV 
SYSSKRNDWN 

SYSSEXIT INT 
SYSSRMS GET 
SYSS$DCLEXH 
SYS$PERSONA EXPORT ARB 
SYSSDALLOC = 
SYSSSETPFM 
SYSSPERSONA CLONE 
SYSS$PERSONA DELETE 
SYS$RMS_CREATE 
SYSSRMS CONNECT 
SYSS$SET PROCESS PROPERTIESW 
SYSS$RMS PARSE 
SYSSPROCESS SCAN 
SYSSSETPRV 


65024 start flags: 


PR RRM DMD KD WW WW WW WWW WUUDD DD ~1 


node: WFGLX4 platform: ALPHA 


PRRFENUNDODDDTDDOWOWTDTONDTOTOrFWDDTDDTONDONDOCONG 


00000003 


ooo oo ow ht oOo co oOo oo Oo oO OU Oo oO oS OW bt oS 


Kernel Rate/sec 


i) 


Re 
oooooooowwwocToooooooooiarcwcdanooon ansoorcdoooc”rao0ouwoco cd ~10 & 


SOCOP RPE EPE ERP ERE RPE EEE ENNYNNNWWWWHR RUUD DAIPNYNWHEUWUNY BU 


oooo”noooc”;nooocooocoocooocoocooocoocoooCoCoOCoCoCOOCOOCOOCOOOCOCOOCOOCOOCOORFP RFP RP RP RP RP NN WW & 
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System Service Logging 
ANALYZE/SSLOG 


This example shows the use of the /STATISTICS qualifier. The output lists the 
most frequently requested service first. Each entry shows the total number of 


requests for that service, a breakdown by access mode, and the rate per second. 


9. anal/sslog/stat=by status 


XK150S$ ANALYZE/SSLOG/STATISTICS=BY STATUS SSLOG.DAT 


START version: 1.1 process: 2020041b SYSTEM !30-AUG-2004 18:30:28.79 
username: SYSTEM node: WFGLX4 platform: ALPHA 


buffer count: 2 size: 65024 start flags: 00000003 


Service Count User Super Exec Kernel Status Rate/sec 
SYSSTRNLNM 168 4 0 164 0 All 4.5 
46 0 0 46 0 000001BC 1.2 

122 4 0 118 0 00000001 3.3 

SYSSRMS SEARCH 129 129 0 0 0 All 3.4 
~ 2 2 0 0 0 00018001 0.1 

126 126 0 0 0 00010001 3.4 

il 1 0 0 0 000182CA 0.0 

SYSS$QIO 121 0 0 94 27 All Be2 
4 0 0 0 4 0000026C 0.1 

117 0 0 94 23 00000001 3.1 

SYSSSYNCH INT 92 88 4 0 0 All 2.5 
> 92 88 4 0 0 00000000 2.5 
SYS$RMS_PUT 85 85 0 0 0 All 263 
84 84 0 0 0 00018001 2.2 

1 1 0 0 0 00000000 0.0 


This example shows the use of /STATISTICS = BY_STATUS. Similar to the 
previous example, it also has an additional line for each status returned by a 
system service. 
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System Service Logging 
SET PROCESS/SSLOG 


SET PROCESS/SSLOG 


Format 


Parameters 


Qualifier 


Description 


Enables or disables System Service Logging. 


SET PROCESS/SSLOG=(STATE={ON | OFF | UNLOAD}[,COUNT=n] [,SIZE=n] 
[,FLAGS=[NOJARGS)) [/ID=id_number] [process-name] 


process-name 
Specifies the name of the process for which logging is to be enabled or disabled. 


COUNT=n 
Specifies how many P2-space buffers to log. The default is 2. 


FLAGS=[NO]JARGS 

Specifies whether or not service argument values are to be logged. The default is 
ARGS, which requires privileges. If the value is ARGS but you lack privilege, no 
argument values are logged. 


STATE=OFF 
Disables (turns off) system service logging. Can be reenabled. 


STATE=ON 
Enables system service logging. 


STATE=UNLOAD 
Stops logging and closes SSLOG.DAT. 


SIZE=n 
Specifies P2-buffer size. The default value for size is 65,0249) or FEO04¢. 


ADENTIFICATION=identification_number 
Specify to target a specific process by number. 


The SET PROCESS/SSLOG command: 

e Enables or disables system service logging 

e Opens the file SSLOG.DAT used to log data 

e Can specify a specific process by name or ID (identification number) 
e Can stop logging and close the file of logged data 


When enabling SSLOG for a process, you specify the number and size of buffers 
to be used for logging. The buffers are allocated in P2 space and are charged 
against the process’s paging file quota. The buffer space remains allocated and 
the quota charged until the process is deleted. 


Between the time SSLOG is first enabled and SSLOG.DAT is closed, logging can 
be stopped and resumed. 
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System Service Logging 
SET PROCESS/SSLOG 


Before the process is deleted, logging should be stopped and the log file closed. 
The log file is not closed automatically. 


Required Privileges 
Requires GROUP privilege to change other processes in the same group. Requires 
WORLD privilege to change processes outside your group. 


To get argument values logged, you need either SETPRV, CMKRNL, or CMEXEC 
privilege. 


Examples 


1. $ SET PROC/SSLOG=(STATE=ON, COUNT=4, SIZE=%XFE00) 


This command turns on system service logging with four P2 space buffers 
each having a size of FE00jg bytes. If the process has SETPRV, CMKRNL, or 
CMEXEC priviledge, argument values are logged. 


2. $ SET PROC/SSLOG=(STATE=UNLOAD ) 
This command stops logging and closes the file SSLOG.DAT. 
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Index 


A 


Access rights block, 2-20 
Access violations, 2-28, 2-29 
ACME.EXE file, 4-38 
ACPs (ancillary control processes), 4-94 
Addition operator (+), 2-16 
Address 
virtual, 4-146 
Addresses, examining, 4-19 
Address operator (@), 2-15 
Address operator (*B), 2-15 
Address operator (*L), 2-15 
Address operator (*P), 2-15 
Address operator (*Q), 2-15 
Address operator (*V), 2-15 
Address operator (*W), 2-15 
Address space number (ASN), 2-18 
ANALYZE/SSLOG command, 14-3 
/BRIEF qualifier, 14-3 
/FULL qualifier, 14-3 
/NORMAL qualifier, 14-3 
/OUTPUT qualifer, 14-3 
/SELECT qualifer, 14-3 
/STATISTICS qualifer, 14-3 
/WIDE qualifier, 14-3 
ANALYZE command 
/CRASH_DUMP qualifier, 2-10, 3-2, 3-4 
/OVERRIDE qualifier, 3-5 
/RELEASE qualifier, 3-6 
/SHADOW_MEMBER qualifier, 3-7 
/SSLOG qualifier, 3-9 
/SYMBOL qualifier, 3-10 
/SYSTEM qualifier, 2-2, 3-2, 3-11 
Analyzing watchpoint results, 13-7 
Ancillary control process 


See ACPs 
AND operator (&), 2-16 
AQBs (ACP queue blocks), 4-96 
ARB symbol, 2-20 
Arithmetic operators, 2-15 
Arithmetic shifting operator (@), 2-16 
ASBs (asynchronous save blocks), 4-59 
ASN register displaying, 4-82 


ASTEN register, displaying, 4-82 
ASTs (asynchronous system traps), 2-18 
ASTSR register, displaying, 4-82 
AST symbols, 2-18 
Asynchronous save blocks 

See ASBs 
Asynchronous system traps 

See ASTs 
At sign (@) 

as Execute command, 4-3 

as shifting operator, 2-16 
ATTACH command, 4-4 

/PARENT qualifier, 4-4 


Backup utility (BACKUP), copying system dump 
file, 2-8 

BDBs (buffer descriptor blocks), 4-59 

BDBSUM (BDB summary page), 4-59 

Binary operators, 2-16 

BLBs (buffer lock blocks), 4—59 

BLBSUM (BLB summary page), 4-59 

Branch registers, 2-18 


Buffer descriptor blocks 
See BDBs 
Buffer lock blocks 
See BLBs 
Bugcheck 
code, 2-22 
DEBUGCRASH, 4-85 
fatal conditions, 2-23 to 2-40 
halt/restart, 2-10 
handling routines 
global symbols, 4-38 
KRNLSTAKNV, 4-85 
reasons for taking, 4-85 
Bundles 
instruction, 4—20 


C 

Call frames 
displaying in SDA, 4-67 
following a chain, 4—67 
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Cancel I/O routine, 4-95 
Catenate operator (.), 2-16 
CCBs (channel control blocks), displaying in SDA, 
4-59 
CDDBs (class driver data blocks), 4-96 
CDRPs (class driver request packets), 4-79, 4-213 
CDTs (connection descriptor tables), 4—79, 4-213 
Channel control blocks 
See CCBs 
/CHANNEL qualifier, 4-185 


Channel request blocks 


See CRBs 
Class driver data blocks 
See CDDBs 
Class driver request packets 
See CDRPs 
CLUBs (cluster blocks), 4—74 
CLUDCBs (cluster quorum disk control blocks), 
4-74 
CLUE$SITE_PROC logical name, 5-15 
CLUE CALL_FRAME command, 5-4 
/ADDRESS qualifier, 5-4 
/CPU qualifier, 5-4 
/IDENTIFICATION qualifier, 5—4 
/INDEX qualifier, 5—4 
/PROCESS qualifier, 5-5 
CLUE CLEANUP command, 5-7 
CLUE commands, archiving information, 2-8 
CLUE CONFIG command, 5-8 
CLUE CRASH command, 2-23, 5-9 
CLUE ERRLOG command, /OLD qualifier, 5-12 
CLUE FRU command, 5-13 
CLUE HISTORY command, /OVERRIDE qualifier, 
5-14 
CLUE MCHK command, 5-16 
CLUE MEMORY command, 5-17 
/FILES qualifier, 5-17 
/FREE qualifier, 5-17 
/FULL qualifier, 5-17 
/LAYOUT qualifier, 5-17 
/LOOKASIDE qualifier, 5-17 
/STATISTIC qualifier, 5-17 
CLUE PROCESS command, 5-25 
/BUFFER qualifier, 5-25 
/LAYOUT qualifier, 5-25 
/LOGICAL qualifier, 5-25 
/RECALL qualifier, 5-25 
CLUE REGISTER command, 5-27 
CLUE SG command, /CRAB qualifier, 5-29 
CLUE STACK command, 5-381 
CLUE SYSTEM command, /LOGICAL qualifier, 
5-34 
CLUE VCC command, 5-35 
/CACHE qualifier, 5-35 
/LIMBO qualifier, 5-35 
/STATISTIC qualifier, 5-35 
/VOLUME qualifier, 5-35 
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CLUE XOP command, /ACTIVE [/FULL] qualifier, 
5-38 
CLUE XQP command, 5-38 
/AQB qualifier, 5-38 
/BFRD qualifier, 5-38 
/BFRL qualifier, 5-38 
/BUFFER [/FULL] qualifier, 5-38 
/CACHE_HEADER qualifier, 5-38 
/FCB [/FULL] qualifier, 5-38 
/FILE qualifier, 5-38 
/GLOBAL qualifier, 5-38 
/LBN_HASH qualifier, 5-38 
/LIMBO qualifier, 5-38 
/LOCK qualifier, 5-39 
/THREAD qualifier, 5-389 
/VALIDATE qualifier, 5-39 
CLUFCBs (cluster failover control blocks), 4—74 
Cluster blocks 
See CLUBs 
Cluster failover control blocks 
See CLUFCBs 
Cluster quorum disk control blocks 
See CLUDCBs 
Cluster system blocks 


See CSBs 
Cluster system identification numbers 


See CSIDs 
CNX$DEBUG.EXE file, 4-38 
Compressed data section, 4-32 
Condition-handling routines, global symbols, 4-38 
Condition values, evaluating, 4-15 
Connection descriptor tables 
See CDTs 
Connection manager, displaying SDA information, 
4-73 
Connections, displaying SDA information about, 
4—79, 4-213 
Contents of stored machine check frames 
displaying in SDA, 4-142 
Context 
SDA CPU, 2-138 
SDA process, 2-12 
Control blocks, formatting, 4-25 
Control region, 2-19 
examining, 4-20 
Control region operator (H), 2-16 
COPY command, 2-7, 2-8, 4-5 
/COMPRESS qualifier, 4-5 
/DECOMPRESS qualifier, 4-5 
/CPU=n qualifier, 4-84 
CPU context 
changing 
using SET CPU command, 4-48 
using SHOW CPU command, 4-81 
using SHOW CRASH command, 4-84 
using SHOW PROCESS command, 4-175 
displaying, 4-81 


CPU database addresses, 4-81 
CPUDB symbol, 2-19 
CPU ID 
See CPU identification number 
CPU identification number, 4-81 
Crash dump 
exception information in, 4-84 
Crash dumps 
file headers, 4-121 
headers, 4-121 
incomplete, 2-10 
short, 2-10 
CRBs (channel request blocks), 4-95 
CREATE command, 2-7 
Creating and deleting watchpoints, 13-3 
CSBs (cluster system blocks), 4-74, 4-79 
CSIDs (cluster system identification numbers), 
4-73, 4-205, 4-206 
Current stack pointer, 2-19 
Cycle counter, 2-18 


D 


Database addresses 

for CPUs, 4-81 
Data structures 

formatting, 4—25 

global symbols, 2-18 

stepping through a linked list, 4-44 
DCLDEFSTB file, 2-18 
DCL interpreter, global symbols, 2-18 
DDBs (device data blocks), 4-94 
DDIF$RMS_EXTENSION.EXE file, 4-38 
DDTs (driver dispatch tables), 4-95 
DEBUGCRASH bugcheck, 4-85 
Debugging system image, 11-2 
DECDTMDEF‘STB file, 2-18 
Decimal value of an expression, 4-15 
DECnet, global symbols, 2-18 
DEFINE command, 4—7, 4—9 

/IF_STATE qualifier, 4-10 

/KEY qualifier, 4-10 

/LOCK_STATE qualifier, 4—10 

/PD qualifier, 4—7 

/SET_STATE qualifier, 4-10 
DEFINE command/TERMINATE qualifier, 4-10 
Delta/XDelta Debugger (DELTA/XDELTA), 1-3 
Device data blocks 

See DDBs 
Device driver routines, address, 4—95 
Devices, displaying SDA information, 4-93 
Division operator (/), 2-16 
DOSD (dump off system disk), 1-4, 5-2 
DPTs (driver prologue tables), 4-94 
Driver dispatch tables 

See DDTs 


Driver prologue tables 


See DPTs 

Dump 
off system disk, 1-4 

DUMPBUG system parameter, 2-3, 2-41 

DUMP command, 4-12 
/COUNT = [{ ALL | records}] qualifier, 4-12 
/DECIMAL qualifier, 4-12 
/FORWARD qualifier, 4-12 
/HEXADECIMAL qualifier, 4-12 
/INDEX_ARRAY [= { LONGWORD | 

QUADWORD)}], 4-12 

/INITIAL_POSITION qualifier, 4-12 
/LONGWORD qualifier, 4-12 
/PHYSICAL qualifier, 4-13 
/QUADWORD qualifier, 4-13 
/RECORD_SIZE=size qualifier, 4-13 
/REVERSE qualifier, 4-13 


Dump file 
analyzing, 3-2 
copying, 4-5 


displaying a summary of, 5-9 
displaying machine check information, 5-16 
displaying memory with CLUE MEMORY, 
5-17 
displaying process information, 5-25 
displaying the current stack, 5-31 
displaying virtual I/O cache, 5-35 
displaying XQP information, 5-38 
extracting errorlog buffers, 5-12 
purging files using CLUE CLEANUP, 5-7 
saving automatically, 2-8, 5-1 
saving output, 5-14 
using CLUE CONFIG, 5-8 
DUMPSTYLE system parameter, 2-5 
DUMP subset, 2-5 


E 


ERRORLOG.STB file, 4-38 
ERRORLOGBUFFERS system parameter, 2-7 
Error logging 
global symbols, 4-38 
routines, 4-38 
Error log messages, 5-12 
ESP symbol, 2-18 
EVALUATE command, 4-15 
/CONDITION_VALUE qualifier, 4-15 
/FPSR qualifier, 4-15 
/IFS qualifier, 4-15 
/ISR qualifier, 4-15 
/NOSYMBOLS qualifier, 4-15 
/PFS qualifier, 4-15 
/PS qualifier, 4-15 
/PSR qualifier, 4-15 
/PTE qualifier, 4-15 
/SYMBOLS qualifier, 4-15 
/TIME qualifier, 4-16 
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EXAMINE command, 4-19 
/ALL qualifier, 4-19 


/CONDITION_VALUE qualifier, 4-19 


/FD qualifier, 4—20 

/FPSR qualifier, 4-19 

/IFS qualifier, 4-19 
/JINSTRUCTION qualifier, 4—20 
/ISR qualifier, 4—20 

/NOPD qualifier, 4—20 
/NOSUPPRESS qualifier, 4—20 
/PO qualifier, 4-20 

/P1 qualifier, 4-20 

/PD qualifier, 4—20 

/PFS qualifier, 4-21 
/PHYSICAL qualifier, 4-21 
/PS qualifier, 4-21 

/PSR qualifier, 4-21 

/PTE qualifier, 4-21 

/SYSTEM qualifier, 4-21 
/TIME qualifier, 4-21 


Floating point 
control register, 2-19 
enable, 2-18 
registers, 2-18 
status register, 2-19 
FLT command, 7-2 
FLT LOAD command, 7-3 
FLT SHOW TRACE command, 7-4 
FLT START TRACE command, 7-5 
FLT STOP TRACE command, 7-6 
FLT UNLOAD command, 7-7 
FORMAT command, 4—25 
/PHYSICAL qualifier, 4-25 
/POSITIVE qualifier, 4—25 
/TYPE qualifier, 4-25 
FPCR register displaying, 4-82 
FPCR symbol, 2-19 
FPSR (Floating-point Register Status) 
evaluating, 4-15 
FPSR symbol, 2-19 


EXCEPTION.STB file global symbols, 4-38 FP symbol, 2-18 
Exception-handling routines, global symbols, 4-38 Frame pointers, 2-18 
Exception information in crash dump, 4—84 FRED symbol, 2-20 


Executive images FSB (file statistics block), 4-59 
contents, 4-38, 4-103 Full and selective dumps, 2-4 
global symbols, 4-36 FWAs (file work areas), 4-59 

Executive register stack pointer, 2-18 

Executive stack pointer, 2-18 G 


EXEC_INIT.STB file, 4-38 
EXIT command, 4-24 GBDs (global buffer descriptors), summary page, 
Exiting from SDA, 4-24 4-59 
Expressions, 2-14 GBHs (global buffer headers), 4—59 

evaluating, 4-15 GBHSH (global buffer hash table), 4-59 
Extended attribute blocks GBSBs (global buffer synchronization blocks), 


See XABs 4-59 
Extended value block, 4-206 Global buffer descriptors 


See GBDs 
F Global buffer hash table 
See GBHSH 
F11BXQPSTB file, 4-38 Global buffer headers 
FABs (file access blocks), 4-59 See GBHs 
Fatal exceptions, 2-23 Global buffer synchronization blocks 
FATALEXCPT bugcheck, 2-23 See GBSBs 


FC$GLOBALS.STB file, 4-38 


Global page tables, displaying, 4-146 
FCBs (file control blocks), 4-59 es ere 


Global pointer, 2-19, 4-104, 4-176 


FEN symbol, 2-18 G operator, 2-15 
File access blocks GP, 4-104 
See FABs G symbol, 2-19 
File control blocks 
See FCBs i-| 
File statistics blocks 
See FSB Headers, crash dump, 4-121 
File systems global symbols, 4-38 HELP command, 4-29 
Mile work areas Hexadecimal value of an expression, 4-15 
See FWAs H operator, 2-16 
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H symbol, 2-19 


I/O databases 
displaying SDA information, 4—93 
global symbols, 2-18 

T/O request packets 


See IRPs 
IDBs (interrupt dispatch blocks), 4-95 
IDXs (index descriptors), 4-59 
IFABs (internal file access blocks), 4-59 
IFIs (internal file identifiers), 4-59 
IFS (Interruption Function State) 
evaluating, 4-15 
Image activator, global symbols, 2-18, 4-39 
IMAGE_MANAGEMENTSSTB file, global symbols, 
4-39 
IMGDEF‘STB file, 2-18 
Implementing the Watchpoint utility, WPDRIVER, 
13-1 
Index descriptors 
See IDXs 
/INDEX qualifier, 4-56 
Initialization code global symbols, 4-38 
Initializing Watchpoint utility, 13-2 
Instruction bundles, 4-20 
Interlocked queues, validating, 4-251 
Internal file access blocks 
See IFABs 
Internal file identifiers 
See IFIs 
Interrupt dispatch blocks 


See IDBs 
INVEXCEPTN bugcheck, 2-23 
IODEF.STB file, 2-18 
I operator, 2-16 
IO_ROUTINES.STB file global symbols, 4-39 
IPL register displaying, 4-82 
IPL symbol, 2-19 
IRABs (internal record access blocks), 4-59 
IRPs (I/O request packets), 4-95 
ISR (Interruption Status Register) 
evaluating, 4-15 
I symbol, 2-19 


J 


JFBs (journaling file blocks), 4-59 
JIBs (job information blocks), 4-182 
JIB symbol, 2-20 
Job information block 

See JIB 
Journaling file blocks 


See JFBs 


K 


Kernel register, 2-19 
Kernel stacks 
displaying contents, 4-226 
pointer, 2-19 
Kernel threads block, 2-20 
Kernel Threads Block 
KTB, 4-182 
Key-less-than block 
See KLTB 
Keys (keyboard), defining for SDA, 4-9 
KLTB (key-less-than block), 4-59 
KRNLSTAKNV bugcheck, 4-85 
KSP symbol, 2-19 
KTB 
kernel threads block, 4-182 
KTB symbol, 2-20 


L 


LAT$RATING.EXE file, 4-39 
LCK$DEBUG.EXE file, 4-39 
Linker map, use in crash dump analysis, 2-23 
Linking two 32-bit values ("."), 2-16 
LKB (lock block), 4-139 
LMF$GROUP_TABLE.EXE file, 4-39 
Location in memory 

examining, 4-19 

SDA default, 4-19 

translating to instruction, 4-19 
LOCKING.STB file, 4-39 
Lock management routines, global symbols, 4-39 
Lock manager, displaying SDA information, 4—137 
Locks, displaying SDA information, 4-205 
Logging 

system service, 1-3, 14-1 
Logical operators, 2-15, 2-16 

AND operator (&), 2-16 

NOT operator (#), 2-15 

OR operator ( | ), 2-16 

XOR operator (\ ), 2-16 
LOGICAL_NAMES.STB file global symbols, 4-39 
Lookaside lists displaying contents, 4-162 


M 


Machine check frames displaying in SDA, 4-142 
MAP command, 4-31 
MCES register displaying, 4-82 
MCES symbol, 2-19 
Mechanism arrays 
Alpha, 2-24 
Memory 
examining, 4-19 
formatting, 4-25 
locations 
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Memory 
locations (cont’d) 
decoding, 4-22 
examining, 4-21 
region 
examining, 4-22 
MESSAGE_ROUTINES.STB file global symbols, 
4-39 
MODIFY DUMP command, 4—34 
/BLOCK=n qualifier, 4-34 
/BYTE command, 4-34 
/CONFIRM=n qualifier, 4-34 
/LONGWORD qualifier, 4-34 
/NEXT qualifier, 4-34 
/OFFSET=n qualifier, 4-34 
/QUADWORD qualifier, 4-34 
/WORD qualifier, 4-34 
MSCP.EXE file, 4-39 
MULTIPATH.STB file, 4-39 
Multiplication operator (*), 2-16 
Multiprocessing, global symbols, 4-41 
Multiprocessors 
analyzing crash dumps, 2-12 
displaying synchronization structures, 4-220 


N 


NAMs (name blocks), 4-60 

Negative operator (—), 2-15 
NET$CSMACD.EXE file, 4-39 
NET$FDDI.EXE file, 4—39 

NETDEF‘STB file, 2-18 

Nonpaged dynamic storage pool, displaying 
contents, 4-162 

NOT operator (#), 2-15 
NT_EXTENSION.EXE file, 4-39 

NWA (network work area), 4-60 


O 


Object rights block, 2-20 

OCLA, 1-4 

OCLA DISABLE command, 6-4 

OCLA DUMP command, 6—5 

OCLA ENABLE command, 6-6 

OCLA HELP command, 6-7 

OCLA LOAD command, 6-8 

OCLA SHOW REGISTER command, 6-9 

OCLA SHOW STATUS command, 6—10 

OCLA SHOW TRACE command, 6-11 

OCLA START command, 6-12 

OCLA STOP command, 6-13 

OCLA UNLOAD command, 6-14 

ODS-5 disks, 4-36 

OpenVMS Cluster environments 
displaying SDA information, 4-73 
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OpenVMS Cluster environments, displaying SDA 
information, 4—73 
OpenVMS Galaxy data structures, symbols, 2-18 
OpenVMS RMS 
See RMS 
Operators (mathematical) 
precedence of, 2-15, 2-16 
ORB symbol, 2-20 
OR operator ( | ), 2-16 


P 


PO region, examining, 4-20 
P1 region, examining, 4-20 
Paged dynamic storage pool displaying contents, 
4-162 
Page faults, illegal, 2-39 
Page files 
See also SYS$SYSTEM:PAGEFILE.SYS file 
Page protections, 4-146 
Page table base register, 2-19 
Page table entries 


See PTEs 
Page tables 
system, 2-5, 2-10 
Page tables, displaying, 4-146, 4-178 
Parentheses (), as precedence operators, 2-16 
PB (path block), 4-95 
PCBB register displaying, 2-19, 4-82 
PCBB symbol, 2-19 
PCBs (process control blocks), 2-20 
displaying, 4-178 
hardware, 4—182 
specifying the address of, 4-56, 4-175 
PCB symbol, 2-20 
PCC (process cycle counter), 2-19 
PCC symbol, 2-19 
PCs (program counters), 2-19 
in acrash dump, 2-22 
PC symbol, 2-19 
PDTs (port descriptor tables), 4-169 
PFN (page frame number) 
See also PFN database 
PFN database, displaying, 4-150, 4-156 
PFS (Previous Function State) 
evaluating, 4-15 
PGFIPLHI bugcheck, 2-39 
PHDs (process headers), 2-20, 4-179 
PHD symbol, 2-20 
Physical address operator (*P), 2-15 
PID numbers, 4-177 
PIO, Use process-permanent I/O data structures, 
4-60 
Pointer 
global, 4-176 


Port drivers, displaying SDA information, 4—73 
Positive operator (+), 2-15 
PRBR register displaying, 4—82 
PRBR symbol, 2-19 
Precedence operators, 2-16 
Privileges 
to analyze a crash dump, 3-2 
to analyze a running system, 2-12, 3-2 
Process contexts, changing, 4—48, 4-56, 4-84, 
4-175 
Process control blocks 
See PCBs and System PCBs 


See system PCBs 
Process control region, 2-19 
operator (H), 2-16 
Processes 
displaying 
SDA information, 4-173, 4-231 
examining hung, 2-12 
image, 4-231 
listening, 4—74 
lock [brief], 4-177 
scheduling state, 4-182, 4-232 
spawning a subprocess, 4-246 
system, 4-56 
Process indexes, 4-177 
Process names, 4-175 
Processor base registers, 2-19 
Processor context, changing, 4-48, 4-81, 4-84, 
4-175 
Processor status 
See PS 
Process section tables 
See PSTs 
PROCESS_MANAGEMENTS:STB file global 
symbols, 4-39 
Program regions, examining, 4—20 
Protections 
page, 4-146 
PS (processor status) 
evaluating, 4-15 
examining, 4-21 
PSB symbol, 2-20 
PSR (Processor Status Register ) 
evaluating, 4-15 
PS symbol, 2-19 
PSTs (process section tables) displaying, 4-179 
PTBR register displaying, 4-82 
PTBR symbol, 2-19 
PTEs (page table entries) 
evaluating, 4-15 
examining, 4-21 


Q 


Quadwords, 4—25 
Qualifier 
/RING_BUFFER, 4-180 
Queues 
stepping through, 4-44 
validating, 4-251 
Quorum, 4-73 


R 


RABs (record access blocks), 4-60 
Radixes, default, 2-15 
Radix operators, 2-15 
RAD symbol, 2-19 
RDTs (response descriptor tables), 4-213 
READ command, 4-37 
/EXECUTIVE qualifier, 4-36 
/FORCE qualifier, 4-36 
/IMAGE qualifier, 4-37 
/LOG qualifier, 4-37 
/NOLOG qualifier, 4-37 
/RELOCATE qualifier, 4-37 
/SYMVA qualifier, 4-37 
SYS$DISK, 4-38 
Record access blocks 
See RABs 
Record lock blocks 
See RLBs 
Recovery unit blocks 
See RUBs 
Recovery unit file blocks 
See RUFBs 
Recovery unit stream blocks 
See RUSBs 
Recovery unit system services, global symbols, 
4-39 
RECOVERY_UNIT_SERVICES.STB file, global 
symbols, 4-39 
Register 
kernel, 2-19 
Registers 
branch, 2-18 
displaying, 4-82, 4-180 
integer, 2-19 
REPEAT command, 4-44 
/UNTIL=condition qualifier, 4—44 
Report system event, global symbols, 4-39 
REQSYSDEF:STB file, 2-18 
Resident images, 4-176, 4-188 
/RESIDENT qualifier installing an image, 4-32 
Resource blocks 
See RSBs 
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Resources, displaying SDA information, 4—203 
Response descriptor tables 
See RDTs 
Response ID 
See RSPID 
/RING_BUFFER qualifier, 4-180 
RLBs (record lock blocks), 4—60 
RMS 
data structures shown by SDA, 4-59 
displaying data structures, 4-180, 4-212 
global symbols, 2-18, 4-39 
RMS.STB file, 4-39 
RMSDEF:STB file, 2-18 
RSBs (resource blocks), 4-189, 4-205 
RSPID (response ID), displaying SDA information, 
4-213 
RUBs (recovery unit blocks), 4-60 
RUFBs (recovery unit file blocks), 4-60 
RUSBs (recovery unit stream blocks), 4-60 


S 


SO region, examining, 4-21 
SAVEDUMP system parameter, 2-7, 2-41 
SBs (system blocks), 4-74, 4-95 
SCBB register, displaying, 4-82 
SCBB symbol, 2-19 
SCC (system cycle counter), 2-19 
SCC symbol, 2-19 
SCD 
See System Code Debugger 
Schedulers, global symbols, 4-39 
SCS (System Communications Services) 
displaying SDA information, 4—73, 4-74, 4-79, 
4-213 
global symbols, 2-18 
SCSDEF:STB file, 2-18 
SDA$ADD_SYMBOL callable routine, 10-9 
SDA$ALLOCATE callable routine, 10-10 
SDA$DBG_IMAGE_INFO callable routine, 10-11 
SDA$DEALLOCATE callable routines, 10-12 
SDA$DISPLAY_HELP callable routine, 10-13 
SDA$ENSURE callable routine, 10-15 
SDA$FAO callable routine, 10-16 
SDA$FORMAT callable routine, 10-18 
SDA$FORMAT_HEADING callable routine, 
10-20 
SDA$GETMEM callable routine, 10-39 
SDA$GET_ADDRESS callable routine, 10-21 
SDA$GET_BLOCK_NAME callable routine, 
10-22 
SDA$GET_BUGCHECK_MSG callable routine, 
10-24 
SDA$GET_CURRENT_CPU callable routine, 
10-26 
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SDA$GET_CURRENT_PCB callable routine, 
10-27 
SDA$GET_DEVICE_NAME callable routine, 
10-28 
SDA$GET_HEADER callable routine, 10-30 
SDA$GET_HW_NAME callable routine, 10-33 
SDA$GET_IMAGE_OFFSET callable routine, 
10-34 
SDA$GET_INPUT callable routine, 10-37 
SDA$GET_LINE_COUNT callable routine, 10-38 
SDA$INIT logical name, 2-11 
SDA$INSTRUCTION_DECODE callable routine, 
10-41 
SDA$NEW_PAGE callable routine, 10-44 
SDA$PARSE_COMMAND eallable routine, 10-45 
SDA$PRINT callable routine, 10-47 
SDA$READ_DIR:REQSYSDEF‘STB file, 2-10, 
2-11 
SDA$READ_DIR:SYS$BASE_IMAGE.EXE file, 
2-10, 2-11 
SDA$READ_DIR:SYSDEFSTB file, 2-11 
SDA$READ_SYMFILE callable routine, 10-49 
SDA$REQMEM callable routine, 10-51 
SDA$SET_ADDRESS callable routine, 10-53 
SDA$SET_CPU callable routine, 10-54 
SDA$SET_HEADING_ROUTINE callable routine, 
10-55 
SDA$SET_LINE_COUNT callable routine, 10-57 
SDA$SET_PROCESS callable routine, 10-58 
SDA$SKIP_LINES callable routine, 10-59 
SDA$SYMBOLIZE callable routine, 10-61 
SDA$SYMBOL VALUE callable routine, 10-60 
SDA$TRYMEN callable routine, 10-63 
SDA$TYPE callable routine, 10-65 
SDA$VALIDATE_QUEUE callable routine, 10-66 
SDA, invoking by default, 2-8 
SDA capabilities, 2-1 
SDA CLUE, dump off system disk, 5-2 
SDA CLUE commands 
archiving dump file information, 5-1 
collecting dump file information, 5-1 
SDA command format, 2-14 
SDA current CPU, 2-18, 4-48, 4-81, 4-84, 4-175, 
4-227 
SDA current process, 2-13, 4-48, 4-56, 4-84, 
4-175, 4-227 
SDA Extended File Cache (XFC) 
commands, 9-1 
XFC, 9-1 
SDA symbol table 
building, 2-11 
expanding, 2-11 
SDD 
See System Dump Debugger 
SEARCH command, 4-46 
/LENGTH qualifier, 4—46 
/MASK=n qualifier, 4—46 
/PHYSICAL qualifier, 4-46 


SEARCH command (cont'd) 
/STEPS qualifier, 4-46 
Section type, 4-176, 4-188 
SECURITY.STB file global symbols, 4-39 
Self-relative queue, validating, 4-251 
SET CPU command, 2-13, 4-48 
analyzing a running system, 2-12 
SET ERASE SCREEN command, 4-50 
SET FETCH command, 4-51 
SET LOG command, 4-53 
compared with SET OUTPUT command, 4-53 
SET NOLOG command, 4-53 
SET OUTPUT command, 4-54 
compared with SET LOG command, 4-53 
/HEADER qualifier, 4-54 
/INDEX qualifier, 4-54 
/NOHEADER qualifier, 4-54 
/NOINDEX qualifier, 4-54 
SET OUTPUT command/PERMANENT qualifier, 
4-54 
SET OUTPUT command/SINGLE_COMMAND 
qualifier, 4-54 
SET PROCESS/SSLOG command, 14-11 
SET PROCESS command, 2-138, 4-56 
/address qualifier, 4-56 
/ID=nn qualifier, 4—56 
/NEXT qualifier, 4-56 
/SYSTEM qualifier, 4-56 
SET RMS command, 4—59 
SET SIGN_EXTEND command, 4-62 
SET SYMBOLIZE command, 4-63 
SFSBs (shared file synchronization blocks), 4-60 
Shadow set displaying SDA information, 4—96 
Shareable address data section, 4-32 
Shared file synchronization blocks 


See SFSBs 
SHOW ADDRESS command, /PHYSICAL 
qualifier, 4-64 
SHOW BUGCHECK command, /ALL qualifier, 
466 
SHOW CALL_FRAME command 
/SUMMARY qualifier, 4-67 
SHOW CALL_FRAME command, /NEXT_FP 
qualifier 
See NEXT_FRAME qualifier, 4-67 
SHOW CALL_FRAME command, /NEXT_FRAME 
qualifier, 4-67 
SHOW CBB command, 4—70 
SHOW CEB command, 4-71 
SHOW CLUSTER command, 4—73 
/ADDRESS qualifier, 4-73 
/CSID qualifier, 4—73 
/NODE qualifier, 4—73 
/SCS qualifier, 4-738 
SHOW CONNECTIONS command, 4-79 
/ADDRESS qualifier, 4—79 
/NODE qualifier, 4—79 
/SYSAP qualifier, 4—79 


SHOW CPU command, 2-13, 4-48, 4-81 
analyzing a running system, 2-12 
SHOW CRASH command, 2-138, 2-23, 4-48, 4-84 
analyzing a running system, 2-12 
/CPU qualifier, 4-84 
SHOW DEVICE command, 2-23, 4-93 
/ADDRESS qualifier, 4-94 
/CDT qualifier, 4-94 
SHOW DUMP command, 4-98 
/ALL qualifier, 4-98 
/BLOCK qualifier, 4-98 
/COMPRESSION_MAP qualifier, 4—98 
/ERROR_LOGS qualifier, 4-98 
/HEADER qualifier, 4-98 
/LMB qualifier, 4-99 
/MEMORY_MAP qualifier, 4-99 
/SUMMARY qualifier, 4-99 
SHOW EXCEPTION_FRAME command, 4-101 
/SUMMARY qualifier, 4-101 
SHOW EXECUTIVE command, 4—103 
/SUMMARY qualifier, 4-103 
SHOW GALAXY command, 4-106 
SHOW GCT command, 4-107 
/ADDRESS qualifier, 4-107 
/ALL qualifier, 4-107 
/CHILDREN qualifier, 4-107 
/HANDLE qualifier, 4-107 
/OWNER qualifier, 4-107 
/SUMMARY qualifier, 4-107 
/type qualifier, 4-108 
SHOW GLOBAL_SECTION_TABLE command, 
4-111 
/SECTION_INDEX qualifier, 4-111 
SHOW GLOCK command, 4-113 
/ADDRESS qualifier, 4-113 
/ALL qualifier, 4-113 
/BRIEF qualifier, 4-113 
/GMDB_TABLE qualifier, 4-113 
/HANDLE qualifier, 4-113 
/PROCESS_TABLE qualifier, 4-113 
/SYSTEM_TABLE, 4-113 
SHOW GMDB command, 4-116 
/ADDRESS qualifier, 4-116 
/ALL qualifier, 4-116 
/NODE qualifier, 4-116 
/SUMMARY qualifier, 4-116 
SHOW GSD command, 4-118 
/ADDRESS qualifier, 4-118 
/ALL qualifier, 4-118 
/DELETED qualifier, 4—118 
/GLXGRP qualifier, 4-118 
/GLXSYS qualifier, 4-118 
/GROUP qualifier, 4-118 
/SYSTEM qualifier, 4-118 
SHOW GST command, 4-111 
SHOW HEADER command, 4-121 
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SHOW IMAGE command, 4-123 SHOW PAGE_TABLE command (cont'd) 


SHOW KFE command, 4-125 /PT qualifier, 4-147 

SHOW LAN command, 4-127 /SOS1 qualifier, 4-147 
/ATM qualifier, 4—127 /S2 qualifier, 4-147 
/CLIENT qualifier, 4-127 /SECTION_INDEX qualifier, 4-147 
/CLUEXIT qualifier, 4-127 /SPTW qualifier, 4-148 
/COUNTERS qualifier, 4-127 SHOW PAGE_TABLE command/HEADER 
/CSMACD qualifier, 4-127 qualifier, 4-146 
/DEVICE qualifier, 4-127 SHOW PARAMETER command, 4-153 
/ELAN qualifier, 4-128 /ACP qualifier, 4-153 
/ERRORS qualifier, 4-128 /ALL qualifier, 4-153 
/FDDI qualifier, 4-128 /CLUSTER qualifier, 4-153 
/FULL qualifier, 4-128 /DYNAMIC qualifier, 4—153 
/INTERNAL qualifier, 4-128 /GALAXY qualifier, 4-153 
/QUEUES qualifier, 4-128 /GEN qualifier, 4-153 
/SOURCEROUTING qualifier, 4-128 /JOB qualifier, 4-153 
/SUMMARY qualifier, 4-128 /LGI qualifier, 4-153 
/TIMESTAMPS qualifier, 4-128 /MAJOR qualifier, 4-153 
/TR qualifier, 4-128 /MULTIPROCESSING qualifier, 4-153 
/UNIT qualifier, 4—128 /OBSOLETE qualifier, 4-153 
/VCI qualifier, 4—128 /PQL qualifier, 4-154 

SHOW LOCKS command, 4-137 /RMS qualifier, 4-154 
/ADDRESS qualifier, 4-137 /SCS qualifier, 4-154 
/ALL qualifier, 4—137 /SPECIAL qualifier, 4-154 
/BLOCKING qualifier, 4-137 /STARTUP qualifier, 4-154 
/BRIEF qualifier, 4-137 /SYS qualifier, 4-154 
/CACHED qualifier, 4—137 /TTY qualifier, 4-154 
/CONVERT qualifier, 4-137 SHOW PFN_DATA command, 4-156 
/GRANTED, 4-137 /ADDRESS qualifier, 4-156 
/NAME qualifier, 4-138 /ALL qualifier, 4-156 
/POOL qualifier, 4-138 /BAD qualifier, 4-156 
/STATUS qualifier, 4-138 /COLOR qualifier, 4-157 
/SUMMARY qualifier, 4-138 /FREE qualifier, 4-157 
/WAITING qualifier, 4-138 /MAP qualifier, 4-157 

SHOW MACHINE_CHECK command, 2-13, /MODIFIED qualifier, 4-157 

4-142 /PRIVATE qualifier, 4-157 

/FULL qualifier, 4-142 /RAD qualifier, 4-157 

SHOW MEMORY command, 2-6, 4-144 /UNTESTED qualifier, 4-158 
/ALL qualifier, 4-144 /ZERO qualifier, 4-158 
/BUFFER_OBJECTS qualifier, 4-144 SHOW POOL command, 4-162 
/CACHE qualifier, 4-144 /ALL qualifier, 4-162 
/FILES qualifier, 4-144 /BAP qualifier, 4-162 
/FULL qualifier, 4-144 /BRIEF qualifier, 4-162 
/GH_REGIONS qualifier, 4-144 /CHECK qualifier, 4-162 
/PHYSICAL_PAGES qualifier, 4-145 /FREE qualifier, 4-162 
/POOL qualifier, 4-145 /HEADER qualifier, 4-162 
/RESERVED qualifier, 4-145 /MAXIMUM_BYTES qualifier, 4-162 
/SLOTS qualifier, 4-145 /NONPAGED qualifier, 4-163 

SHOW PAGE_TABLE command, 4-146 /PAGED qualifier, 4-163 
/FREE qualifier, 4-146 /RING_BUFFER qualifier, 4-163 
/GLOBAL qualifier, 4—146 /STATISTICS qualifier, 4-163 
/GPT qualifier, 4-147 /SUBTYPE qualifier, 4-163 
/INVALID_PRN qualifier, 4-147 /SUMMARY qualifier, 4-163 
/L1 qualifier, 4—147 /TYPE qualifier, 4-163 
/L2 qualifier, 4—147 SHOW PORTS command 
/L qualifier, 4-147 /ADDRESS qualifier, 4-169 
/NONMEMORY qualifier, 4-147 /BUS qualifier, 4-169 
/PTE_ADDRESS qualifier, 4-147 /CHANNEL qualifier, 4-169 
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SHOW PORTS command (cont’d) 
/DEVICE qualifier, 4-169 
/MESSAGE qualifier, 4-169 
/NODE qualifier, 4-169 
/VC qualifier, 4-169 

SHOW PRN_DATA command 
/SYSTEM qualifier, 4-158 

SHOW PROCESS/ALL command, 4-182 

SHOW PROCESS/LOCKS command, 4-139 

SHOW PROCESS/RMS command, 4-212 
selecting display options, 4-60 

SHOW PROCESS command, 4-57, 4-175 
/ADDRESS qualifier, 4-175 
/ALL qualifier, 4-175 
/AUTHORIZED qualifier, 4—175 
/BRIEF qualifier, 4-176 
/BUFFER_OBJECTS qualifier, 4-176 
/CHANNEL qualifier, 4-176 
/FANDLES qualifier, 4-176 
/FID_ONLY qualifier, 4—176 
/FREE qualifier, 4-176 
/GSTX qualifier, 4-176 
/HEADER qualifier, 4-176 
ID qualifier, 4-176 
JIMAGES qualifier, 4-176 
/INDEX qualifier, 4-176 
/INVALID_PFN qualifier, 4-177 
/LOCKS qualifier, 4-177 
/MAXIMUM_BYTES qualifier, 4-177 
/NEXT qualifier, 4-177 
/NONMEMORY_PFN qualifier, 4-178 
/PAGE_TABLES qualifier, 4-178 
/PCB qualifier, 4-178 
/PERSONA/RIGHTS/AUTHORIZED qualifier, 

4-179 
/PERSONA/RIGHTS qualifier, 4-179 
/PERSONA qualifier, 4-178 
/PHD qualifier, 4-179 
/POOL qualifier, 4-179 
/PPT qualifier, 4-179 
/PROCESS_SECTION_TABLE qualifier, 4-179 
/PST qualifier, 4-179 
/PTE_ADDRESS qualifier, 4-179 
/PT qualifier, 4-179 
/RDE qualifier, 4-179 
/REGIONS qualifier, 4-179 
/REGISTERS qualifier, 4-180 
/RIGHTS qualifier, 4-180 
/RING_BUFFER qualifier, 4-180 
/RMS qualifier, 4-180 
/SECTION_INDEX qualifier, 4-180 
/SEMAPHORE qualifier, 4-180 
/STATISTICS qualifier, 4-180 
/SUBTYPE qualifier, 4-180 
/SUMMARY qualifier, 4-180 
/SYSTEM qualifier, 4-181 
/THREADS qualifier, 4-181 
/TQE qualifier, 4-181 


SHOW PROCESS command (cont’d) 
/TYPE qualifier, 4-181 
/UNUSED qualifier, 4-181 
/UNWIND qualifier, 4-181 
/WORKING_SET_LIST qualifier, 4-181 

SHOW RAD command, /ALL qualifier, 4-201 

SHOW RESOURCES command, 4-139, 4-203 
/ADDRESS qualifier, 4-203 
/ALL qualifier, 4-203 
/BRIEF qualifier, 4—203 
/CACHED qualifier, 4-203 
/CONTENTION qualifier, 4-203 
/LOCKID qualifier, 4-203 
/NAME qualifier, 4-204 
/OWNED qualifier, 4-204 
/STATUS qualifier, 4-204 

SHOW RMD command, 4-210 
/ADDRESS qualifier, 4-210 
/ALL qualifier, 4-210 

SHOW RMS command, 4-212 

SHOW RSPID command, /CONNECTION 

qualifier, 4-213 

SHOW SHM_CPP command, 4-215 
/ADDRESS qualifier, 4-215 
/ALL qualifier, 4-215 
JIDENT qualifier, 4-215 
/PFN qualifier, 4-215 

SHOW SHM_REG command, 4-218 
/ADDRESS qualifier, 4-218 
/ALL qualifier, 4-218 
/JIDENT qualifier, 4-218 

SHOW SPINLOCKS command, 4-221 
/ADDRESS qualifier, 4-220 
/BRIEF qualifier, 4-220 
/CACHED_PCB qualifier, 4—220 
/COUNTS qualifier, 4-220 
/DYNAMIC qualifier, 4-220 
/FULL qualifier, 4—220 
/INDEX qualifier, 4—220 
/MAILBOX qualifier, 4—221 
/OWNED qualifier, 4-221 
/PCB qualifier, 4-221 
/PORT qualifier, 4-221 
/STATIC qualifier, 4-221 

SHOW STACK command, 4-226 
/ALL qualifier, 4-226 
/EXECUTIVE qualifier, 4-226 
/INTERRUPT qualifier, 4-226 
/KERNEL qualifier, 4-226 
/LONG qualifier, 4-226 
/PHYSICAL qualifier, 4-226 
/QUAD qualifier, 4-226 
/SUPERVISOR qualifier, 4-226 
/SYSTEM qualifier, 4-227 
/USER qualifier, 4-227 

SHOW SUMMARY command, 4-175, 4-231 
/IMAGE qualifier, 4-231 
/PROCESS_NAME qualifier, 4-231 
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SHOW SUMMARY command (cont’d) 
/THREAD qualifier, 4-231 
/USER qualifier, 4-231 
/VALUE qualifier, 4—236 

SHOW SWIS command, 4—234 
/CPU qualifier, 4-234 
/RING_BUFFER qualifier, 4-234 

SHOW SYMBOL command, 4-236 
/ALL qualifier, 4-236 
/ALPHA qualifier, 4—236 

SHOW TQE command, 4-238 
/ADDRESS qualifier, 4-238 
/ALL qualifier, 4-238 
/BACKLINK qualifier, 4-238 
/PID qualifier, 4-238 
/ROUTINE qualifier, 4-238 

SHOW TQEIDX command, 4-241 
/ADDRESS qualifier, 4-241 

SHOW UNWIND command, 4-242 
/ALL qualifier, 4-242 


SHOW WORKING SET LIST command, 4-244 


Signal array, 2-28 
SISR register, displaying, 4-82 
SISR symbol, 2-19 


Site-specific startup command procedure, 2-8, 


5-15 
releasing page file blocks, 2-7 


Software interrupt status register, 2-19 


SPAWN command, 4-246 
/INPUT qualifier, 4-246 


/NOLOGICAL_NAMES qualifier, 4-246 


/NOSYMBOLS qualifier, 4-246 

/NOTIFY qualifier, 4-246 

/NOWAIT qualifier, 4-246 

/OUTPUT qualifier, 4-246 

/PROCESS qualifier, 4-247 
Spinlocks 


displaying SDA information, 4-220 


owned, 4-82 
Spinlock tracing, 8-1 
Spinlock Tracing utility, using, 8-2 
SPL$DEBUG.EXE file, 4-39 
SPL ANALYZE 


/NOCPU_STATISTICS qualifier, 8-4 


SPL ANALYZE command, 8—4 
/CPU_STATISTICS qualifier, 8-4 
SPL LOAD command, 8-7 
SPL SHOW COLLECT 
/TOTALS qualifier, 8-8 


SPL SHOW COLLECT command, 8-8 


/RATES qualifier, 8-8 

SPL SHOW TRACE 
/NOWAIT qualifier, 8-9 
/WAIT qualifier, 8-9 

SPL SHOW TRACE command, 8-9 
/ACQUIRE qualifier, 8-9 
/FORKLOCK qualifier, 8-9 
/FRKDSPTH qualifier, 8-9 
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SPL SHOW TRACE command (cont’d) 
/FRKEND qualifier, 8-10 
/NOACQUIRE qualifier, 8-9 
/NOFORKLOCK qualifier, 8—9 
/NOFRKDSPTH qualifier, 8-9 
/NOFRKEND qualifier, 8-10 
/NORELEASE qualifier, 8-9 
/NOSPINLOCK qualifier, 8-9 
/RATES qualifier, 8-9 
/RELEASE qualifier, 8-9 
/SPINLOCK qualifier, 8-9 
/SUMMARY qualifier, 8-10 
/TOP qualifier, 8-10 
/TOTALS qualifier, 8-9 

SPL START COLLECT command 
/ADDRESS qualifier, 8-14 
/SPINLOCK qualifier, 8-14 

SPL START TRACE 
/FORKLOCK qualifier, 8-15 
/FRKDSPTH qualifier, 8-15 
/NOFORKLOCK qualifier, 8-15 
/NOFRKDSPTH qualifier, 8-15 

SPL START TRACE command 
/ACQUIRE qualifier, 8-15 
/BUFER qualifier, 8-15 
/CPU qualifier, 8-16 
/FRKEND qualifier, 8-16 
/NOACQUIRE qualifier, 8-15 
/NOFRKEND qualifier, 8-16 
/NORELEASE qualifier, 8-15 
/NOSPINLOCK qualifier, 8-15 
/NOWAIT qualifier, 8-15 
/RELEASE qualifier, 8-15 
/SPINLOCK qualifier, 8-15 
/WAIT qualifier, 8-15 

SPL STOP COLLECT command, 8-17 

SPL STOP TRACE command, 8-18 

SPL UNLOAD command, 8-19 

SP symbol, 2-19 


SPTs (system page tables), displaying, 4-146 
SPTs (system page tables), in system dump file, 


2-5 

SSLOG 

SET PROCESS command, 14-11 
SSPI.EXE file, 4-39 
SSP symbol, 2-19 
SSRVEXCEPT bugcheck, 2-23 
Stack frames 

displaying in SDA, 4-67 

following a chain, 4—67 
Stack pointer 

executive register, 2-18 
Stacks displaying contents, 4-226 
Start I/O routine, 4—95 
Subprocesses, 4-246 
Subtraction operator (—), 2-16 


Supervisor stack 
displaying contents, 4-226 
pointer to, 2-19 
Symbols 
defining 
for SDA, 4-7 
evaluating, 4-236 
listing, 4-236 
loading into the SDA symbol table, 4-37 
name, 4—7 
representing executive modules, 4-104 
user-defined, 4—7 
Symbol table files reading into SDA symbol table, 
4-38 
Symbol tables, specifying an alternate SDA, 3-10 
SYS$ATMWORKS351.EXE file, 4—40 
SYS$CLUSTER.EXE file, 4—40 
SYS$DISK 
as SDA output, 4-54 
global read, 4-38 
SYS$EW1000A.EXE file, 4—40 
SYS$EW5700.EXE file, 4—40 
SYS$GALAXY:.STB file, 4—40 
SYS$IPC_SERVICES.EXE file, 4—40 
SYS$LAN.EXE file, 4—40 
SYS$LAN_ATM.EXE file, 4—40 
SYS$LAN_ATM4.EXE file, 4—40 
SYS$LAN_CSMACD.EXE file, 4—40 
SYS$LAN_FDDI.EXE file, 4—40 
SYS$LAN_TR.EXE file, 4—40 
SYS$LOADABLE_IMAGES:SYS.EXE file contents, 
4-38 
SYS$MME_SERVICES.STB file, 4—40 
SYS$NTA.STB file, 4—40 
SYS$SCS.EXE file, 4—40 
SYS$SYSTEM:PAGEFILE.SYS file, 2-41 


See also System dump files 

as dump file, 2-7 

releasing blocks containing a crash dump, 3-6 
SYS$SYSTEM:SYS.EXE file, 4-36 

contents, 4-103 
SYS$SYSTEM:SYSDEE:STB file, 2-12 
SYS$SYSTEM:SYSDUMP.DMP file, 2-41 

See also System dump files 

protection, 2-8 

size of, 2-6 
SYS$TRANSACTION_SERVICES.EXE file, 4—40 
SYS$UTC_SERVICES.EXE file, 4—40 
SYS$XFCACHE*.STB file, 4-40 
SYSAP (system application), 4-213 
SYSDEVICE.STB file global symbols, 4—41 
SYSGETSYI.STB file global symbols, 4—41 
SYSLDR_DYN.STB file global symbols, 4—41 
SYSLICENSE.STB file global symbols, 4—41 
System blocks 


See SBs 


System Code Debugger, 1-2, 11-1 

interface options, 11-2 

networking, 11-10 

starting, 11-9 
System Code Debugger, sample session, 11-15 
System Code Debugger commands, 11-9 
System Communications Services 


See SCS 
System control block base register, 2-19 
System Dump Analyzer (SDA) commands, 11-10 
System Dump Analyzer utility (SDA), 1-2 
invoked automatically on reboot, 5-1 
System Dump Debugger, 1-3, 12-1 
access to symbols in 
OpenVMS executive images, 12-6 
limitations, 12-6 
preparing a System Dump, 12-2 
sample session, 12-6 
setting up test system, 12-3 
setting up the build system, 12-3 
starting, 12-4 
summary of commands, 12-4 
user-interface options, 12-2 
using commands, 12-5 
System dump files, 2-3 to 2-7 
mapping physical memory to, 2-10 
requirements for analysis, 2-10 
System failures 
analyzing, 2-22 
causing, 2—41 to 2-42 
diagnosing from PC contents, 2-22 
summary, 4-84 
System hang, 2-41 
System images 
contents, 4-38, 4-103 
global symbols, 4-36 
System management creating a crash dump file, 
2-3 
System message routines global symbols, 4-39 
System page file 
as dump file, 2-7 
releasing blocks containing a crash dump, 3-6 
System page tables, 2-5, 2-10 
See SPTs 
System PCBs (process control blocks) displaying, 
4-181 
System processes, 4-56 
System region, examining, 4-21 
Systems 
analyzing running, 2-2, 2-12, 3-2 
investigating performance problems, 2-12 
System service logging, 14-1 
System Service Logging, 1-3 
System space base address, 2-19 
System space operator (G), 2-15 
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System symbol table, 2-10 
System time quadword examining, 4-21 
SYSTEM_DEBUG.EXE file, 4-41 
SYSTEM_PRIMITIVES.STB file global symbols, 
4-41 
SYSTEM_SYNCHRONIZATION_xxx.STB file 
global symbols, 4-41 


T 


TCPIP$BGDRIVER.STB global symbols, 4—41 
TCPIP$INTEETACP.STB global symbols, 4—41 
TCPIP$INTERNET_SERVICES.STB global 

symbols, 4-41 
TCPIP$NET_GLOBALS.STB file, 2-18 
TCPIP$NFS_GLOBALS.STB file, 2-18 
TCPIP$NFS_SERVICES.STB file, 4-41 
TCPIP$PROXY_GLOBALS.STB file, 2-18 
TCPIP$PROXY_SERVICES.STB file, 4—41 
TCPIP$PWIPACP.STB global symbols, 4—41 
TCPIP$PWIPDRIVER.STB global symbols, 4—41 
TCPIP$PWIP_GLOBALS.STB file, 2-18 
TCPIP$TNDRIVER.STB global symbols, 4—41 
TCPIP$TN_GLOBALS.STB file, 2-18 
Terminal keys defining for SDA, 4-9 
TMSCP.EXE file, 4-41 
Trace table entries 

See WPPTEs 

Transaction processing, global symbols, 2-18 


U 


UCBs (unit control blocks), 4—79 
Unary operators, 2-15 to 2-16 
UNDEFINE command, 4-248 
Unit control blocks 
See UCBs 
UNXSIGNAL bugcheck, 2-23 
Use process-permanent I/O data structures 
See PIO 
User stacks 
displaying contents, 4-227 
pointer, 2-19 
Using the $QIO interface Watchpoint utility, 13-3 
Using the Spinlock Tracing utility, 8-2 
USP symbol, 2-19 


V 


VALIDATE PFN_LIST command, 4—249 
/ALL qualifier, 4-249 
/BAD qualifier, 4—249 
/FREE qualifier, 4-249 
/MODIFIED qualifier, 4-249 
/PRIVATE qualifier, 4-249 
/UNTESTED qualifier, 4-249 
/ZERO qualifier, 4-249 
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VALIDATE QUEUE command, 4-251 
/BACKLINK qualifier, 4—251 
/LIST qualifier, 4-251 
/PHYSICAL qualifier, 4-251 
/QUADWORD qualifier, 4-251 
/SELF_RELATIVE qualifier, 4-251 
/SINGLY_LINKED qualifier, 4-251 

VALIDATE SHM_CPP command, 4-253 
/ADDRESS qualifier, 4-253 
/ALL qualifier, 4-253 
/IDENT qualifier, 4-253 
/PRN qualifier, 4-253 

VALIDATE TQEIDX command, 4-255 

Value block 
extended, 4-206 

VCBs (volume control blocks), 4—96 

Virtual address, 4-146 

Virtual address operator (*V), 2-15 

VMS_EXTENSION.EXE file, 4-41 

Volume control blocks 
See VCBs 

Votes, 4-73 

VPTB register, displaying, 4-82 

VPTB symbol, 2-20 


W 


WAIT command, 4-256 
Watchpoint control blocks 

See WPCBs 
Watchpoint protection, 13-9 
Watchpoint restore entries 

See WPREs 
Watchpoint restrictions, 13-10 
Watchpoint utility, 1-3 
Watchpoint utility (WP) 

implementation, 13-1 
WCBs (window control blocks), 4-60 
Window control blocks 

See WCBs 
WPCBs (watchpoint control blocks), 13-6 
WPDRIVER 

data structures, 13-6 

device driver, 13-1 

invoking, 13-5 
WPPTEs (trace table entries), 13-7 
WPREs (watchpoint restore entries), 13-6 


X 


XABs (extended attribute blocks), 4-60 
XDELTA breakpoint, 13-3 
XFC 
SDA Extended File Cache, 9-1 
XFC EXIT command, 9-2 


XFC LOAD DSF command, 9-3 

XFC SHOW CONTEXT command, 9-5 
XFC SHOW EXTENT command, 9-7 
XFC SHOW FILE command, 9-8 

XFC SHOW MEMORY command, 9-11 
XFC SHOW SUMMARY command, 9-14 
XFC SHOW TABLES command, 9-18 
XFC SHOW TRACE command, 9-20 
XFC SHOW VOLUME command, 9-22 
XOR operator (\), 2-16 
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